题目
 
分别编写名字为TestPackageCalss和MyException类，实现一下功能：在控制台串中输入一串字符，并判断，如果是整数字符串，则转换成Ingeger对象，如果是浮点数字符串则转换成Double对象，并格式化为 $#....#.##（不用四舍五入输出进度到小数点后面两位），如果是非数字，则抛出显式抛出自定义异常类MyException，异常信息是“输入了数据无法实现数字格式转换"。
 
（作业题，描述不太严谨，按照大概意思来即可）
 
说明
 
这个作业题不是重点，本博客重点是：以该题目为切入点，如何去写校验【正整数】和【浮点数】格式的正则表达式。正则表达式一般去网上找就行了，但掌握正则表达式的基础知识并会写简单的正则表达式也比较重要。
 
分析
 
1.整数
 
问：如何理解正确的整数格式？
 
举例：0，-1235，102340。。。这个不好说，只能靠意会
 
问：什么是不正确的整数格式？
 
举例：000，-0，+0，03524。。。显然一般来说，正确的整数格式是：不会有前导0的
 
 
 
先来看看网上找到的一个校验整数的正则表达式
 
String regex="^-?\\d+$";
 
还算比较简单吧。很容易看出来，这个正则表达式会错判有前导0的情况，会认为000，-0，+0，03524...这些是正确。
 
仅仅从作业题来看，Java种的 Integer.valueOf(str) 的 str 是允许前导0的，str 有前导0，该函数也能成功转换，并不会抛出异常。那么如果只是为了做这个作业题，这个正则表达式够用了。
 
假设OJ上有这么一题：
 
 
 
题目
 
 
      请编写程序，判断给出的字符串是否符合正确的整数格式。
 
 
      正确的整数格式：0，-1235，102340。。。
 
 
      不正确的整数格式：000，-0，+0，03524。。
 
 
输入格式
 
 
      每一行输入一个字符串，输入若干行。
 
 
输出格式
 
 
      符合格式输出“yes”，否则输出“no”。
 
 
C/C++肯定是可以做的，但不好做。对于学习C/C++的同学来说，这是一道不错的考察字符串的题目。
 
 
 
铺垫了这么多。进入正题。
 
正确的整数格式分两种情况来考虑
 
（1）0。为什么0如此特殊以至于单独作为一种情况？因为防止这样的数据：-0，000，00。。。
 
（2）非0。有没有负号都是可以的，但第一位数字必定是[1-9]，因为不能有前导0！随后的数位可以是[0-9]。
 
总结出规律，那么这个正则表达式就非常简单了
 
String regex="(-?[1-9]\\d*)|0";
 
 
 
2.浮点数
 
显然校验浮点数比校验整数复杂得多。考虑的情况很多，可能会有点乱。所以思考的时候注重角度。
 
 
 
明确一点：小数点只是正确的浮点数的格式的一个显著特征，一个符合正确格式的浮点数不一定要有小数点
 
例如：1.0符合浮点数的格式，1也认为是正确的浮点数格式。
 
 可以这样认为：符合整数格式的字符串都符合浮点数格式。
 
 
 
正确的浮点数格式，分两个角度来考虑
 
（1）整数部分
 
浮点数的整数部分的校验能否直接搬上面校验整数的正则表达式？
 
不可以！为什么？
 
举例：-0.68是正确的浮点数格式，但如果搬上面的正则表达式校验其整数部分，-0.68会被认为有前导0而被错判！
 
整数部分的正则表达式：-?(0|[1-9]\\d*)
 
注意对比以下校验正整数的正则表达式，体会以下有什么不同？对比以下，可以看出0放在括号里面了，就是为了考虑到-0.68这种情况。
 
（2）小数部分
 
小数部分就非常简单了：(\\.\\d+)?
 
只要有小数点，后面必须有至少一位数字[0-9]。前面也说了，由于小数部分不是必须的，所以括起来然后加了个？
 
另外注意：由于“.”有特殊含义，在正则表达式表示：除了换行符以外的任意一个字符。故需要转义。
 
可以这样理解 “\\.”：① “\\” 转义成 “\ ”；② “\.” 转义成 “.”
 
 
 
合起来得到
 
String regex="-?(0|[1-9]\\d*)(\\.\\d+)?";
 
但是
 
这个正则表达式仍会错判一个特殊情况：-0。 但它不会错判-00，-000。。。
 
想想为什么？
 
假如有小数部分，整数部分是可以允许是-0的。假如没有小数部分，整数部分不能是-0！正则表达式在校验整数部分时，还不知道后面有没有小数部分。
 
如何规避这种情况？
 
重新分类，重写正则表达式？
 
没必要。
 
若想在正则表达式中规避-0的情况，就要另外分类，将-0的情况单独分处理，但如果这样去干正则表达式就会变得冗长，
         且分类多了就容易重叠混乱，造成越想追求完美结果就越多bug的得不偿失。既然只有这一种特例，如果需要，在正则
         表达式外面特判即可。
 
代码
 
下面给出这个作业题的完整代码。
 
package theme4;

import java.text.DecimalFormat;
import java.util.Scanner;

/**
 * 分别编写名字为TestPackageCalss和MyException类，实现一下功能：在控制台串中输入一串字符，并判断，
 * 如果是整数字符串，则转换成Ingeger对象，如果是浮点数字符串则转换成Double对象，并格式化为 $#....#.##
 * （不用四舍五入输出进度到小数点后面两位，），如果是非数字，则抛出显式抛出自定义异常类MyException，
 * 异常信息是“输入了数据无法实现数字格式转换";
 */
public class TestPackageCalss {
	
	public static void main(String[] args) {
		//System.out.println(isDoubleFormat("-00"));
		testInteger();
		testDouble();
	}
	
	public static void testInteger()
	{
		System.out.println("请输入一个符合正确格式的整数字符串：");
		Scanner sc=new Scanner(System.in);
		String num=sc.nextLine();
		
		try {
			Integer intObj=strToInteger(num);
			System.out.println("成功将字符串转成Integer对象");
			System.out.println(intObj);
		} catch (MyException e) {
			System.out.println(e.getMessage());
		} finally {
			sc.close();
		}
	}
	
	public static void testDouble()
	{
		System.out.println("请输入一个符合正确格式的浮点数字符串：");
		Scanner sc=new Scanner(System.in);
		String num=sc.nextLine();
		
		try {
			Double doubleObj=strToDouble(num);
			String pattern="#.00";
			DecimalFormat myFormat=new DecimalFormat(pattern);
			System.out.println(myFormat.format(doubleObj));
		} catch (MyException e) {
			System.out.println(e.getMessage());
		} finally {
			sc.close();
		}
	}
	
	public static Integer strToInteger(String num) throws MyException
	{
		if(isIntegerFormat(num))
			return Integer.valueOf(num);
		else
			throw new MyException("字符串格式异常");
	}
	
	public static Double strToDouble(String num) throws MyException
	{
		if(isDoubleFormat(num))
			return Double.valueOf(num);
		else
			throw new MyException("字符串格式异常");
	}
	
	public static boolean isIntegerFormat(String num)
	{
		
		String regex="(-?[1-9]\\d*)|0"; 
		return num.matches(regex);
	}
	
	public static boolean isDoubleFormat(String num)
	{
		String regex="-?(0|[1-9]\\d*)(\\.\\d+)?";
		if(num.equals("-0"))
			return false;
		return num.matches(regex);
	}
	
	
}
 
 
 
package theme4;

/**
 * 自定义异常类
 * @author passerbyYSQ
 *
 */
public class MyException extends Exception {
	
	static final long serialVersionUID = -33875169934229948L;
	
	public MyException()
	{
		
	}
	
	public MyException(String msg)
	{
		super(msg);
	}
	
}
 
备注
 
自己写的正则表达式，没有严格测试过。如有错误，轻喷。。

将xml文件用浏览器打开，浏览器如果识别出是xml就可以运行。
 
以树状结构展示出来，你就可看到相应借点之间的关系是否正确，是否在正确的位置。
 
就可以看出xml的问题所在了。
 
例如下面的的hibernate实体类文件User.hbm.xml
 
------------------------------------------------------
 
<?xml version="1.0" encoding="gb18030"?>
 <!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
 "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
 <hibernate-mapping>
     <class name="hib.model.User" table="T_USER" schema="SCOTT" >
         <id name="id" type="java.lang.String">
             <column name="ID" length="20" />
             <generator class="assigned" />
         </id>
         <property name="username" type="java.lang.String">
             <column name="USERNAME" length="20" not-null="true">
                 <comment>用户名称</comment>
             </column>
         </property>
         <property name="age" type="java.lang.Integer">
             <column name="AGE" length="10" not-null="true" />
         </property>
     </class>
 </hibernate-mapping>
 -----------------------------------------------------------------
 
 
 
 
进行观察之后发现

 
正确规范写接口文档
 

 

 
前言
 
　　正规的团队合作或者是项目对接，接口文档是非常重要的，一般接口文档都是通过开发人员写的。一个工整的文档显得是非重要。下面我总结下自己看到的优秀接口文档。
 

 

 
接口规范内容
 

  
接口名称
场景说明
接口说明
请求参数
响应参数
错误码
 
 
参数内容
 

  
字段名 
变量名 
是否必填 
类型 
示例值 
描述
 
 
错误码内容
 

  
名称 
描述 
原因 
解决方案
 
 

 

 
一.银联接口文档示例 （适用于接口规范文件）
 

 
5.2.2 统一收单线下交易查询
 

 
5.2.2.1 场景说明
 
收单机构可以通过该接口主动查询订单状态，完成下一步的业务逻辑。需要调用查询接口的情况:
 
当收单机构后台、网络、服务器等出现异常，收单机构系统最终未接收到支付通知;调用支付接口后，返回系统错误或未知交易状态情况;调用alipay.trade.pay，返回INPROCESS的状态;调用alipay.trade.cancel之前，需确认支付状态。
 

 

 
5.2.2.2 接口说明
 
公共请求参数中的method填写alipay.trade.query。
 

 

 
5.2.2.2.1 请求参数
 
参数
参数名
类型
是否必填
最大长度
描述
示例值
out_trade_no
商户订单号
String
否
32
订单支付时传入的商户订单号,和网联交易号不能同时为空。trade_no,out_trade_no如果同时存在优先取trade_no
20150320010101001
...
...
...
...
...
...
...
trade_no
网联交易号
String
否
64
网联交易号，和商户订单号不能同时为空
2014112611001004680073956707
 

 

 
5.2.2.2.2 响应参数
 
参数
参数名
类型
是否必填
最大长度
描述
示例值
trade_no
网联交易号
String
是
64
网联交易号
2013112011001000000121536
...
...
...
...
...
...
...
out_trade_no
商户订单号
String
是
32
商户订单号
6823789339978240
 

 
TradeFundBill字段说明:
 
参数
参数名
类型
是否必填
最大长度
描述
示例值
fund_channel
资金渠道
String
是
32
交易使用的资金渠道
ALIPAYACCOUNT
...
...
...
...
...
...
...
 

 

 
5.2.2.3 错误码
 
错误码
错误描述
原因
解决方案
SYSTEMERROR
接口返回错误
系统超时
请不要更换商户退款单号，请使用相同 参数再次调用 API。
NOTENOUGH
余额不足
商户可用退 款余额不足
此状态代表退款申请失败，商户可根据 具体的错误 示做相应的处理。
...
...
...
...
 

 

 
二.API开发接口文档示例 （适用于http、https 接口）
 

 
3.1.1 查询排重接口
 

 
3.1.1.1 场景说明
 
查询信息是否已存在。
 

 

 
3.1.1.2 接口详情
 

 
3.1.2.1 接口地址
 
接口详情
 
地址
http://www.baidu.com （正式环境）
请求方式
GET
 

 

 
3.1.2.2 参数
 
参数
是否必填
说明
idfa
是
广告标识符
...
...
...
source
是
渠道来源，具体值在接入时再进行分配
 

 

 
3.1.2.3 返回结果
 
返回结果
格式
JSON
状态码
10000
success（调用成功）
 
...
...
 
10010
access prohibited(访问拒绝)
 

 

 
3.1.1.3 调取示例
 

 
3.1.1.3.1 查询成功
 

  
{ 
"state": 10000, 
"message": "success", 
"data": { 
"BD239708-2874-417C-8292-7E335A537FAD": 1 //已经存在 
} 
} 
{ 
"state": 10000, 
"message": "success", 
"data": { 
"BD239708-2874-417C-8292-7E335A537FAD": 0 //不存在 
} 
}
 
 

 

 
3.1.1.3.2 接口调用失败
 

  
{ 
"state": 10010, 
"message": "access prohibited", 
"data": [ 
] 
}
 
 

一，前端jsp页面有一文本框输入时间  HH：mm：ss格式的   另一个文本框要求输入yyyymmdd格式的日期
 
       时间：
 
       由于未用到任何时间插件，只能通过js校验输入的时间是否正确，最简单的莫过于使用正则来校验了，
 
       var regex = /^(([0-2][0-3])|([0-1][0-9])):[0-5][0-9]:[0-5][0-9]$/;
 
       var一个正则表达式，这个表达式检验的就是hh：mm：ss格式的字符串。
 
       但是如果用户只输入10:20，而最后的  ：00  省略掉，难道要提示用户重新输入吗？
 
       NO，只需要改一下正则表达式即可。
 
       var regexs = /^(([0-2][0-3])|([0-1][0-9])):[0-5][0-9]$/;
 
       这个正则和上边的相比只是把最后的  ：ss   给去掉了。
 
       日期：
 
       直接在js中通过Date对象来进行校验,但是这种方式不推荐使用，因为在java中Date date = new Date(yyyy,mm,dd);这个方法已经不推荐了。
 
二，校验
 
       然后，我们就可以写js来校验了
        
 
       //提交表单

       function submit(){
              //时间

              var time = form.time.value;
              
              var regex = /^(?:(?:[0-2][0-3])|(?:[0-1][0-9])):[0-5][0-9]:[0-5][0-9]$/;

              if(!regex.test(time)){

                      var regexs = /^(?:(?:[0-2][0-3])|(?:[0-1][0-9])):[0-5][0-9]$/;

                      if(!regexs.test(time)){

                          alert("时间格式不正确，请输入正确格式如   10：20 或 10:20:20")；

                          form.time.focus();//获取焦点

                          return；

                         }

                         form.time.value = time + ":00";

              }
                
              //日期
              var riqi = form.riqi.value;
              if(riqi != ''){
                    var xxDate = new 
                     Date(riqi.substring(0,4),riqi.substring(4,6)-1,riqi.substring(6,8));
                    if(riqi.substring(0,4) != xxDate.getFullYear() || riqi.substring(4,6) != xxDate.getMonth() || riqi.substring(6,8) != xxDate.getDate()){

                        alert("日期格式不正确，")；

                          form.riqi.focus();//获取焦点

                          return；
}
                }

       }
 
三，正则
 
       在刚开始不太熟悉正则的时候我的js校验代码是介个样子的：
 
function isTime(timeStr){
    var parts;
    parts = timeStr.spilt(":");
    if(parts.length < 1){
        return false;
    }
    
    for(i=0;i<parts.length;i++){
        if(isNaN(parts[i])){
            return false;
        }
    }
    h = parts[0];
    m = parts[1];
    if(h<0||h>23){
        return false;
    }
    if(m<0||m>59){
        return false;
    }
    if(parts.length == 3){
        if(parts[2]<0 || parts[2]>59){
            return false;
        }
    }
    return true;
}
 
    这段代码和上边的正则没有对比就没有伤害。
 
    建议正则不太熟悉的去深入了解一下。