├── .gitignore
├── src
    ├── main
    │   └── java
    │   │   └── com
    │   │       └── github
    │   │           └── miemiedev
    │   │               └── mybatis
    │   │                   └── callable
    │   │                       ├── handler
    │   │                           ├── CallableResultHandler.java
    │   │                           └── SimpleResultHandler.java
    │   │                       ├── CallableConvertInterceptor.java
    │   │                       └── support
    │   │                           └── PropertiesHelper.java
    └── test
    │   ├── resources
    │       ├── logback.xml
    │       ├── mybatis-config.xml
    │       └── User.mbts.xml
    │   └── java
    │       └── com
    │           └── github
    │               └── miemiedev
    │                   └── mybatis
    │                       └── callable
    │                           ├── SimulateBaseDao.java
    │                           └── CallableTester.java
├── README.md
└── pom.xml


/.gitignore:
--------------------------------------------------------------------------------
1 | .idea
2 | *.iml


--------------------------------------------------------------------------------
/src/main/java/com/github/miemiedev/mybatis/callable/handler/CallableResultHandler.java:
--------------------------------------------------------------------------------
 1 | package com.github.miemiedev.mybatis.callable.handler;
 2 | 
 3 | import org.apache.ibatis.mapping.ParameterMapping;
 4 | 
 5 | import java.util.List;
 6 | import java.util.Map;
 7 | 
 8 | /**
 9 |  * 结果处理器
10 |  * Created by limiemie on 2014/3/26.
11 |  */
12 | public interface CallableResultHandler {
13 |     public Object proceed(List<ParameterMapping> parameterMappings, Map<String,Object> result);
14 | }
15 | 


--------------------------------------------------------------------------------
/src/test/resources/logback.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <configuration>
 3 |     <jmxConfigurator />
 4 | 
 5 |     <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
 6 |         <encoder>
 7 |             <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
 8 |         </encoder>
 9 |     </appender>
10 | 
11 | 
12 |     <!-- project default level -->
13 |     <logger name="com.github.miemiedev.mybatis.paginator" level="DEBUG" />
14 |     <logger name="db.table" level="DEBUG" />
15 | 
16 | 
17 | 
18 |     <!--log4jdbc -->
19 |     <!-- <logger name="jdbc.sqltiming" level="INFO"/> -->
20 | 
21 |     <root level="WARN">
22 |         <appender-ref ref="console" />
23 |     </root>
24 | </configuration>


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | 支持Mybatis的版本 >= 3.1
 2 | 
 3 | 使用方法 -->  [CallableTester.java](https://github.com/miemiedev/mybatis-callable/blob/master/src/test/java/com/github/miemiedev/mybatis/callable/CallableTester.java) 和 [User.mbts.xml](https://github.com/miemiedev/mybatis-callable/blob/master/src/test/resources/User.mbts.xml)
 4 | 
 5 | 插件配置 -->  [mybatis-config.xml](https://github.com/miemiedev/mybatis-callable/blob/master/src/test/resources/mybatis-config.xml)
 6 | 
 7 | Downloading from the Maven central repository
 8 | ```xml
 9 | <dependencies>
10 |   ...
11 |     <dependency>
12 |         <groupId>com.github.miemiedev</groupId>
13 |         <artifactId>mybatis-callable</artifactId>
14 |         <version>1.0</version>
15 |     </dependency>
16 |  ...
17 | </dependencies>
18 | ```


--------------------------------------------------------------------------------
/src/test/java/com/github/miemiedev/mybatis/callable/SimulateBaseDao.java:
--------------------------------------------------------------------------------
 1 | package com.github.miemiedev.mybatis.callable;
 2 | 
 3 | import org.apache.ibatis.io.Resources;
 4 | import org.apache.ibatis.session.SqlSession;
 5 | import org.apache.ibatis.session.SqlSessionFactory;
 6 | import org.apache.ibatis.session.SqlSessionFactoryBuilder;
 7 | import org.junit.After;
 8 | import org.junit.Before;
 9 | 
10 | import java.io.IOException;
11 | import java.io.InputStream;
12 | 
13 | /**
14 |  * @author miemiedev
15 |  */
16 | public class SimulateBaseDao {
17 | 
18 |     private SqlSessionFactory sqlSessionFactory;
19 | 
20 |     @Before
21 |     public void init() throws IOException {
22 |         String resource = "mybatis-config.xml";
23 |         InputStream inputStream = Resources.getResourceAsStream(resource);
24 |         sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
25 | 
26 |     }
27 | 
28 |     @After
29 |     public void close(){
30 | 
31 |     }
32 | 
33 |     public SqlSession getSqlSession(){
34 |         return sqlSessionFactory.openSession();
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/test/resources/mybatis-config.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8" ?>
 2 | <!DOCTYPE configuration
 3 |         PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
 4 |         "http://mybatis.org/dtd/mybatis-3-config.dtd">
 5 | <configuration>
 6 |     <settings>
 7 |         <setting name="jdbcTypeForNull" value="NULL"/>
 8 |     </settings>
 9 |     <plugins>
10 |         <plugin interceptor="com.github.miemiedev.mybatis.callable.CallableConvertInterceptor">
11 |         </plugin>
12 |     </plugins>
13 | 
14 |     <environments default="development">
15 |         <environment id="development">
16 |             <transactionManager type="JDBC"/>
17 |             <dataSource type="POOLED" >
18 |                 <property name="driver" value="oracle.jdbc.OracleDriver"/>
19 |                 <property name="url" value="jdbc:oracle:thin:@10.29.20.209:1521:orcl"/>
20 |                 <property name="username" value="mobile_csm"/>
21 |                 <property name="password" value="mobile_csm"/>
22 |                 <property name="poolMaximumActiveConnections" value="50"/>
23 |             </dataSource>
24 |         </environment>
25 |     </environments>
26 | 
27 |     <mappers>
28 |         <mapper resource="User.mbts.xml"/>
29 |     </mappers>
30 | 
31 | 
32 | </configuration>


--------------------------------------------------------------------------------
/src/test/resources/User.mbts.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
 3 | "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
 4 | 
 5 | <mapper namespace="db.table.user">
 6 | 
 7 | 
 8 |     <resultMap type="java.util.HashMap" id="hashMap"></resultMap>
 9 | 
10 |     <!-- 只有标记为CALLABLE的才会走拦截器 -->
11 |     <select id="query" statementType="CALLABLE">
12 |         <![CDATA[
13 |             {call test_proc(
14 |                 #{retCode,mode=OUT,jdbcType=INTEGER},
15 |                 #{acResult,mode=OUT,jdbcType=CURSOR,javaType=ResultSet, resultMap=hashMap},
16 |                 #{userType},
17 |                 #{branchCode}
18 |             )}
19 |         ]]>
20 |     </select>
21 | 
22 | 
23 |     <select id="query2" statementType="CALLABLE">
24 |         <![CDATA[
25 |             {call test_proc2(
26 |                 #{acResult,mode=OUT,jdbcType=CURSOR,javaType=ResultSet, resultMap=hashMap},
27 |                 #{userType},
28 |                 #{branchCode}
29 |             )}
30 |         ]]>
31 |     </select>
32 | 
33 | 
34 |     <select id="query3" statementType="CALLABLE">
35 |         <![CDATA[
36 |             {call test_proc3(
37 |                 #{retCode,mode=OUT,jdbcType=INTEGER},
38 |                 #{userType},
39 |                 #{branchCode}
40 |             )}
41 |         ]]>
42 |     </select>
43 | 
44 | 
45 | 
46 | </mapper>


--------------------------------------------------------------------------------
/src/main/java/com/github/miemiedev/mybatis/callable/handler/SimpleResultHandler.java:
--------------------------------------------------------------------------------
 1 | package com.github.miemiedev.mybatis.callable.handler;
 2 | 
 3 | import org.apache.ibatis.mapping.ParameterMapping;
 4 | import org.apache.ibatis.mapping.ParameterMode;
 5 | import org.apache.ibatis.type.JdbcType;
 6 | 
 7 | import java.sql.ResultSet;
 8 | import java.util.ArrayList;
 9 | import java.util.HashMap;
10 | import java.util.List;
11 | import java.util.Map;
12 | 
13 | /**
14 |  * 单游标结果集
15 |  * Created by limiemie on 2014/3/26.
16 |  */
17 | public class SimpleResultHandler implements CallableResultHandler {
18 |     public Object proceed(List<ParameterMapping> parameterMappings, Map<String, Object> result) {
19 |         List list = new ArrayList();
20 |         Map<String,Object> map = new HashMap<String, Object>();
21 |         for (ParameterMapping parameterMapping : parameterMappings){
22 |             if(ParameterMode.OUT.equals(parameterMapping.getMode()) || ParameterMode.INOUT.equals(parameterMapping.getMode())){
23 |                 list.add(result.get(parameterMapping.getProperty()));
24 |                 map.put(parameterMapping.getProperty(),result.get(parameterMapping.getProperty()));
25 |             }
26 |         }
27 |         if(list.size() == 1){
28 |             Object value = list.get(0);
29 |             if(value instanceof List){
30 |                 return value;
31 |             }
32 |             return list;
33 |         }
34 |         list.clear();
35 |         list.add(map);
36 |         return list;
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/src/test/java/com/github/miemiedev/mybatis/callable/CallableTester.java:
--------------------------------------------------------------------------------
 1 | package com.github.miemiedev.mybatis.callable;
 2 | import org.apache.ibatis.session.ResultContext;
 3 | import org.apache.ibatis.session.ResultHandler;
 4 | import org.apache.ibatis.session.SqlSession;
 5 | import org.junit.Test;
 6 | 
 7 | import java.io.IOException;
 8 | import java.util.HashMap;
 9 | import java.util.List;
10 | import java.util.Map;
11 | 
12 | /**
13 |  * @author miemiedev
14 |  */
15 | 
16 | public class CallableTester extends SimulateBaseDao{
17 | 
18 |     @Test
19 |     public void controllerMethod() {
20 |         Map<String, Object> map = query("yhfl_nbyh", "QLJNWS0102");
21 |         System.out.println(map);
22 |     }
23 | 
24 |     public Map<String, Object> query(String userType, String branchCode){
25 |         SqlSession session = null;
26 |         try{
27 |             session = getSqlSession();
28 |             Map<String, Object> params = new HashMap<String, Object>();
29 |             params.put("userType",userType);
30 |             params.put("branchCode",branchCode);
31 |             //存储过程返回多个参数，则使用selectOne返回Map
32 |             //key为返回参数名，value为返回值
33 |             Map<String, Object> value =  session.selectOne("db.table.user.query", params);
34 |             return value;
35 |         }finally {
36 |             session.close();
37 |         }
38 |     }
39 | 
40 |     @Test
41 |     public void controllerMethod2() {
42 |         List<Map<String, Object>> list = query2("yhfl_nbyh", "QLJNWS0102");
43 |         System.out.println(list);
44 |     }
45 | 
46 |     public List<Map<String, Object>> query2(String userType, String branchCode){
47 |         SqlSession session = null;
48 |         try{
49 |             session = getSqlSession();
50 |             Map<String, Object> params = new HashMap<String, Object>();
51 |             params.put("userType",userType);
52 |             params.put("branchCode",branchCode);
53 |             //存储过程只返回一个游标，则使用selectList返回List
54 |             List<Map<String, Object>> value =  session.selectList("db.table.user.query2", params);
55 |             return value;
56 |         }finally {
57 |             session.close();
58 |         }
59 |     }
60 | 
61 |     @Test
62 |     public void controllerMethod3() {
63 |         Integer returnCode = query3("yhfl_nbyh", "QLJNWS0102");
64 |         System.out.println(returnCode);
65 |     }
66 | 
67 |     public Integer query3(String userType, String branchCode){
68 |         SqlSession session = null;
69 |         try{
70 |             session = getSqlSession();
71 |             Map<String, Object> params = new HashMap<String, Object>();
72 |             params.put("userType",userType);
73 |             params.put("branchCode",branchCode);
74 |             //存储过程只有一个返回值，并且不是游标，则使用selectOne
75 |             Integer value =  session.selectOne("db.table.user.query3", params);
76 |             return value;
77 |         }finally {
78 |             session.close();
79 |         }
80 |     }
81 | 
82 | }
83 | 


--------------------------------------------------------------------------------
/src/main/java/com/github/miemiedev/mybatis/callable/CallableConvertInterceptor.java:
--------------------------------------------------------------------------------
 1 | package com.github.miemiedev.mybatis.callable;
 2 | 
 3 | import com.github.miemiedev.mybatis.callable.handler.CallableResultHandler;
 4 | import com.github.miemiedev.mybatis.callable.handler.SimpleResultHandler;
 5 | import com.github.miemiedev.mybatis.callable.support.PropertiesHelper;
 6 | import org.apache.ibatis.executor.Executor;
 7 | import org.apache.ibatis.mapping.*;
 8 | import org.apache.ibatis.plugin.*;
 9 | import org.apache.ibatis.session.ResultHandler;
10 | import org.apache.ibatis.session.RowBounds;
11 | import org.slf4j.Logger;
12 | import org.slf4j.LoggerFactory;
13 | 
14 | import java.util.*;
15 | 
16 | /**
17 |  * 存储过程调用规则
18 |  * Created by limiemie on 2014/3/26.
19 |  */
20 | @Intercepts({@Signature(
21 |         type= Executor.class,
22 |         method = "query",
23 |         args = {MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class})})
24 | public class CallableConvertInterceptor implements Interceptor {
25 |     private static Logger logger = LoggerFactory.getLogger(CallableConvertInterceptor.class);
26 |     static int MAPPED_STATEMENT_INDEX = 0;
27 |     static int PARAMETER_INDEX = 1;
28 |     static int ROWBOUNDS_INDEX = 2;
29 |     static int RESULT_HANDLER_INDEX = 3;
30 | 
31 |     CallableResultHandler callableResultHandler = new SimpleResultHandler();
32 | 
33 |     public Object intercept(Invocation invocation) throws Throwable {
34 |         final Executor executor = (Executor) invocation.getTarget();
35 |         final Object[] queryArgs = invocation.getArgs();
36 |         final MappedStatement ms = (MappedStatement)queryArgs[MAPPED_STATEMENT_INDEX];
37 |         final Object parameter = queryArgs[PARAMETER_INDEX];
38 | 
39 |         if(!ms.getStatementType().equals(StatementType.CALLABLE)){
40 |             return invocation.proceed();
41 |         }
42 | 
43 |         BoundSql boundSql = ms.getBoundSql(parameter);
44 |         List<ParameterMapping> parameterMappings = boundSql.getParameterMappings();
45 | 
46 |         Map<String, Object> parameterMap = new HashMap<String, Object>();
47 |         if(parameter instanceof Map){
48 |             parameterMap = (Map)parameter;
49 |         }else{
50 |             for (ParameterMapping parameterMapping : parameterMappings) {
51 |                 if(parameterMapping.getMode().equals(ParameterMode.IN) || parameterMapping.getMode().equals(ParameterMode.INOUT)){
52 |                     parameterMap.put(parameterMapping.getProperty(),parameter);
53 |                 }
54 |             }
55 |         }
56 | 
57 |         for (ParameterMapping parameterMapping : parameterMappings) {
58 |             if(parameterMapping.getMode().equals(ParameterMode.OUT)){
59 |                 parameterMap.put(parameterMapping.getProperty(),null);
60 |             }
61 |         }
62 | 
63 |         queryArgs[PARAMETER_INDEX] = parameterMap;
64 | 
65 |         invocation.proceed();
66 | 
67 |         return callableResultHandler.proceed(parameterMappings, parameterMap);
68 |     }
69 | 
70 |     public Object plugin(Object target) {
71 |         return Plugin.wrap(target, this);
72 |     }
73 | 
74 |     public void setProperties(Properties properties) {
75 |         PropertiesHelper propertiesHelper = new PropertiesHelper(properties);
76 |         String dialectClass = propertiesHelper.getProperty("resultHandler","com.github.miemiedev.mybatis.callable.handler.SimpleResultHandler");
77 |         try {
78 |             setResultHandler((CallableResultHandler) Class.forName(dialectClass).newInstance());
79 |         } catch (Exception e) {
80 |             throw new RuntimeException("cannot create resultHandler instance by resultHandler:"+dialectClass,e);
81 |         }
82 |     }
83 | 
84 |     public void setResultHandler(CallableResultHandler resultHandler) {
85 |         logger.debug("resultHandler: {} ", resultHandler.getClass().getName());
86 |         this.callableResultHandler = resultHandler;
87 |     }
88 | }
89 | 


--------------------------------------------------------------------------------
/pom.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | <project xmlns="http://maven.apache.org/POM/4.0.0"
  3 |          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4 |          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5 |     <modelVersion>4.0.0</modelVersion>
  6 |     <parent>
  7 |         <groupId>org.sonatype.oss</groupId>
  8 |         <artifactId>oss-parent</artifactId>
  9 |         <version>7</version>
 10 |     </parent>
 11 | 
 12 |     <groupId>com.github.miemiedev</groupId>
 13 |     <artifactId>mybatis-callable</artifactId>
 14 |     <version>1.0</version>
 15 |     <packaging>jar</packaging>
 16 |     <name>mybatis-callable</name>
 17 |     <description>A Mybatis plugin, implementation of database query Stored Procedure</description>
 18 |     <url>https://github.com/miemiedev/mybatis-callable</url>
 19 |     <licenses>
 20 |         <license>
 21 |             <name>The Apache Software License, Version 2.0</name>
 22 |             <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
 23 |             <distribution>repo</distribution>
 24 |         </license>
 25 |     </licenses>
 26 |     <scm>
 27 |         <connection>scm:git:git@github.com:miemiedev/mybatis-callable.git</connection>
 28 |         <developerConnection>scm:git:git@github.com:miemiedev/mybatis-callable.git</developerConnection>
 29 |         <url>git@github.com:miemiedev/mybatis-callable.git</url>
 30 |     </scm>
 31 |     <developers>
 32 |         <developer>
 33 |             <id>miemiedev</id>
 34 |             <name>Bin Li</name>
 35 |             <email>dev@miemie.li</email>
 36 |         </developer>
 37 |     </developers>
 38 | 
 39 |     <properties>
 40 |         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 41 |     </properties>
 42 | 
 43 |     <build>
 44 |         <plugins>
 45 |             <plugin>
 46 |                 <groupId>org.apache.maven.plugins</groupId>
 47 |                 <artifactId>maven-compiler-plugin</artifactId>
 48 |                 <version>3.0</version>
 49 |                 <configuration>
 50 |                     <source>1.5</source>
 51 |                     <target>1.5</target>
 52 |                 </configuration>
 53 |             </plugin>
 54 |             <plugin>
 55 |                 <groupId>org.apache.maven.plugins</groupId>
 56 |                 <artifactId>maven-gpg-plugin</artifactId>
 57 |                 <executions>
 58 |                     <execution>
 59 |                         <id>sign-artifacts</id>
 60 |                         <phase>verify</phase>
 61 |                         <goals>
 62 |                             <goal>sign</goal>
 63 |                         </goals>
 64 |                     </execution>
 65 |                 </executions>
 66 |             </plugin>
 67 |         </plugins>
 68 |     </build>
 69 | 
 70 | 
 71 |     <dependencies>
 72 |         <dependency>
 73 |             <groupId>org.mybatis</groupId>
 74 |             <artifactId>mybatis</artifactId>
 75 |             <version>3.1.0</version>
 76 |         </dependency>
 77 |         <dependency>
 78 |             <groupId>org.slf4j</groupId>
 79 |             <artifactId>slf4j-api</artifactId>
 80 |             <version>1.7.2</version>
 81 |         </dependency>
 82 |         <dependency>
 83 |             <groupId>ch.qos.logback</groupId>
 84 |             <artifactId>logback-classic</artifactId>
 85 |             <version>1.0.10</version>
 86 |             <scope>provided</scope>
 87 |         </dependency>
 88 | 
 89 |         <dependency>
 90 |             <groupId>junit</groupId>
 91 |             <artifactId>junit</artifactId>
 92 |             <version>4.11</version>
 93 |             <scope>test</scope>
 94 |         </dependency>
 95 |         <dependency>
 96 |             <groupId>com.oracle</groupId>
 97 |             <artifactId>ojdbc6</artifactId>
 98 |             <version>11.2.0.2.0</version>
 99 |             <scope>test</scope>
100 |         </dependency>
101 |         <dependency>
102 |             <groupId>mysql</groupId>
103 |             <artifactId>mysql-connector-java</artifactId>
104 |             <version>5.1.25</version>
105 |             <scope>test</scope>
106 |         </dependency>
107 |     </dependencies>
108 | </project>


--------------------------------------------------------------------------------
/src/main/java/com/github/miemiedev/mybatis/callable/support/PropertiesHelper.java:
--------------------------------------------------------------------------------
  1 | package com.github.miemiedev.mybatis.callable.support;
  2 | 
  3 | import java.io.*;
  4 | import java.util.*;
  5 | import java.util.Map.Entry;
  6 | 
  7 | /**
  8 |  * Properties的操作的工具类,为Properties提供一个代理增加相关工具方法如 getRequiredString(),getInt(),getBoolean()等方法
  9 |  * 并可以通过systemPropertiesMode属性指定是否搜索System.getProperty()及System.getenv()来查找值.
 10 |  * 默认不搜索系统属性
 11 |  * 
 12 |  * <pre>
 13 |  * 使用1:
 14 |  * public class ConnectionUtils {
 15 |  *     static Properties properties = new Properties(); 
 16 |  *     // ... do load properties 
 17 |  *     
 18 |  *     // delegate to properties
 19 |  * 	   static PropertiesHelper props = new PropertiesHelper(properties);
 20 |  *     public static Connection getConnection() {
 21 |  *     		// use getRequiredProperty() 
 22 |  *     		DriverManager.getConnection(props.getRequiredString("jdbc.url"));
 23 |  *     }
 24 |  * }
 25 |  * 指定是否搜索系统属性:
 26 |  * new PropertiesHelper(properties,PropertiesHelper.SYSTEM_PROPERTIES_MODE_OVERRIDE)
 27 |  * </pre>
 28 |  * @author badqiu
 29 |  */
 30 | public class PropertiesHelper {
 31 | 	/** Never check system properties. */
 32 | 	public static final int SYSTEM_PROPERTIES_MODE_NEVER = 0;
 33 | 
 34 | 	/**
 35 | 	 * Check system properties if not resolvable in the specified properties.
 36 | 	 * This is the default.
 37 | 	 */
 38 | 	public static final int SYSTEM_PROPERTIES_MODE_FALLBACK = 1;
 39 | 
 40 | 	/**
 41 | 	 * Check system properties first, before trying the specified properties.
 42 | 	 * This allows system properties to override any other property source.
 43 | 	 */
 44 | 	public static final int SYSTEM_PROPERTIES_MODE_OVERRIDE = 2;
 45 | 	
 46 | 	private int systemPropertiesMode = SYSTEM_PROPERTIES_MODE_NEVER;
 47 | 	private Properties p;
 48 | 
 49 | 	public PropertiesHelper(Properties p) {
 50 | 		setProperties(p);
 51 | 	}
 52 | 	
 53 | 	public PropertiesHelper(Properties p, int systemPropertiesMode) {
 54 | 		setProperties(p);
 55 | 		if(systemPropertiesMode != SYSTEM_PROPERTIES_MODE_NEVER && systemPropertiesMode != SYSTEM_PROPERTIES_MODE_FALLBACK && systemPropertiesMode != SYSTEM_PROPERTIES_MODE_OVERRIDE) {
 56 | 			throw new IllegalArgumentException("error systemPropertiesMode mode:"+systemPropertiesMode);
 57 | 		}
 58 | 		this.systemPropertiesMode = systemPropertiesMode;
 59 | 	}
 60 | 	
 61 | 	public Properties getProperties() {
 62 | 		return p;
 63 | 	}
 64 | 	
 65 | 	public void setProperties(Properties props) {
 66 | 		if(props == null) throw new IllegalArgumentException("properties must be not null");
 67 | 		this.p = props;
 68 | 	}
 69 | 	
 70 | 	public String getRequiredString(String key) {
 71 | 		String value = getProperty(key);
 72 | 		if(isBlankString(value)) {
 73 | 			throw new IllegalStateException("required property is blank by key="+key);
 74 | 		}
 75 | 		return value;
 76 | 	}
 77 | 	
 78 | 	public String getNullIfBlank(String key) {
 79 | 		String value = getProperty(key);
 80 | 		if(isBlankString(value)) {
 81 | 			return null;
 82 | 		}
 83 | 		return value;
 84 | 	}
 85 | 	
 86 | 	public String getNullIfEmpty(String key) {
 87 | 		String value = getProperty(key);
 88 | 		if(value == null || "".equals(value)) {
 89 | 			return null;
 90 | 		}
 91 | 		return value;
 92 | 	}
 93 | 	
 94 | 	/**
 95 | 	 * 尝试从System.getProperty(key)及System.getenv(key)得到值
 96 | 	 * @return
 97 | 	 */
 98 | 	public String getAndTryFromSystem(String key) {
 99 | 		String value = getProperty(key);
100 | 		if(isBlankString(value)) {
101 | 			value = getSystemProperty(key);
102 | 		}
103 | 		return value;
104 | 	}
105 | 
106 | 	private String getSystemProperty(String key) {
107 | 		String value;
108 | 		value = System.getProperty(key);
109 | 		if(isBlankString(value)) {
110 | 			value = System.getenv(key);
111 | 		}
112 | 		return value;
113 | 	}
114 | 	
115 | 	public Integer getInteger(String key) {
116 | 		String v = getProperty(key);
117 | 		if(v == null){
118 | 			return null;
119 | 		}
120 | 		return Integer.parseInt(v);
121 | 	}
122 | 	
123 | 	public int getInt(String key,int defaultValue) {
124 | 		if(getProperty(key) == null) {
125 | 			return defaultValue;
126 | 		}
127 | 		return Integer.parseInt(getRequiredString(key));
128 | 	}
129 | 	
130 | 	public int getRequiredInt(String key) {
131 | 		return Integer.parseInt(getRequiredString(key));
132 | 	}
133 | 	
134 | 	public Long getLong(String key) {
135 | 		if(getProperty(key) == null) {
136 | 			return null;
137 | 		}
138 | 		return Long.parseLong(getRequiredString(key));
139 | 	}
140 | 	
141 | 	public long getLong(String key,long defaultValue) {
142 | 		if(getProperty(key) == null) {
143 | 			return defaultValue;
144 | 		}
145 | 		return Long.parseLong(getRequiredString(key));
146 | 	}
147 | 	
148 | 	public Long getRequiredLong(String key) {
149 | 		return Long.parseLong(getRequiredString(key));
150 | 	}
151 | 	
152 | 	public Boolean getBoolean(String key) {
153 | 		if(getProperty(key) == null) {
154 | 			return null;
155 | 		}
156 | 		return Boolean.parseBoolean(getRequiredString(key));
157 | 	}
158 | 	
159 | 	public boolean getBoolean(String key,boolean defaultValue) {
160 | 		if(getProperty(key) == null) {
161 | 			return defaultValue;
162 | 		}
163 | 		return Boolean.parseBoolean(getRequiredString(key));
164 | 	}
165 | 	
166 | 	public boolean getRequiredBoolean(String key) {
167 | 		return Boolean.parseBoolean(getRequiredString(key));
168 | 	}
169 | 	
170 | 	public Float getFloat(String key) {
171 | 		if(getProperty(key) == null) {
172 | 			return null;
173 | 		}
174 | 		return Float.parseFloat(getRequiredString(key));
175 | 	}
176 | 	
177 | 	public float getFloat(String key,float defaultValue) {
178 | 		if(getProperty(key) == null) {
179 | 			return defaultValue;
180 | 		}
181 | 		return Float.parseFloat(getRequiredString(key));
182 | 	}
183 | 	
184 | 	public Float getRequiredFloat(String key) {
185 | 		return Float.parseFloat(getRequiredString(key));
186 | 	}
187 | 	
188 | 	public Double getDouble(String key) {
189 | 		if(getProperty(key) == null) {
190 | 			return null;
191 | 		}
192 | 		return Double.parseDouble(getRequiredString(key));
193 | 	}
194 | 	
195 | 	public double getDouble(String key,double defaultValue) {
196 | 		if(getProperty(key) == null) {
197 | 			return defaultValue;
198 | 		}
199 | 		return Double.parseDouble(getRequiredString(key));
200 | 	}
201 | 	
202 | 	public Double getRequiredDouble(String key) {
203 | 		return Double.parseDouble(getRequiredString(key));
204 | 	}
205 | 	
206 | 	/** setProperty(String key,int value) ... start */
207 | 	
208 | 	public Object setProperty(String key,int value) {
209 | 		return setProperty(key, String.valueOf(value));
210 | 	}
211 | 	
212 | 	public Object setProperty(String key,long value) {
213 | 		return setProperty(key, String.valueOf(value));
214 | 	}
215 | 	
216 | 	public Object setProperty(String key,float value) {
217 | 		return setProperty(key, String.valueOf(value));
218 | 	}
219 | 	
220 | 	public Object setProperty(String key,double value) {
221 | 		return setProperty(key, String.valueOf(value));
222 | 	}
223 | 	
224 | 	public Object setProperty(String key,boolean value) {
225 | 		return setProperty(key, String.valueOf(value));
226 | 	}
227 | 
228 | 	public String[] getStringArray(String key) {
229 | 		String v = getProperty(key);
230 | 		if(v == null) {
231 | 			return new String[0];
232 | 		}else {
233 | 		    return tokenizeToStringArray(v, ", \t\n\r\f");
234 | 		}
235 | 	}
236 | 
237 | 	public int[] getIntArray(String key) {
238 | 		return toIntArray(getStringArray(key));
239 | 	}
240 | 
241 | 	public Properties getStartsWithProperties(String prefix) {
242 | 		if(prefix == null) throw new IllegalArgumentException("'prefix' must be not null");
243 | 		
244 | 		Properties props = getProperties();
245 | 		Properties result = new Properties();
246 | 		for(Entry<Object, Object> entry : props.entrySet()) {
247 | 			String key = (String)entry.getKey();
248 | 			if(key != null && key.startsWith(prefix)) {
249 | 				result.put(key.substring(prefix.length()), entry.getValue());
250 | 			}
251 | 		}
252 | 		return result;
253 | 	}
254 | 	
255 | 	/** delegate method start */
256 | 	
257 | 	public String getProperty(String key, String defaultValue) {
258 | 	    String value = getProperty(key);
259 | 	    if(isBlankString(value)) {
260 | 	        return defaultValue;
261 | 	    }
262 | 		return value;
263 | 	}
264 | 
265 | 	public String getProperty(String key) {
266 | 		String propVal = null;
267 | 		if (systemPropertiesMode == SYSTEM_PROPERTIES_MODE_OVERRIDE) {
268 | 			propVal = getSystemProperty(key);
269 | 		}
270 | 		if (propVal == null) {
271 | 			propVal = p.getProperty(key);
272 | 		}
273 | 		if (propVal == null && systemPropertiesMode == SYSTEM_PROPERTIES_MODE_FALLBACK) {
274 | 			propVal = getSystemProperty(key);
275 | 		}
276 | 		return propVal;
277 | 	}
278 | 
279 | 	public Object setProperty(String key,String value) {
280 | 		return p.setProperty(key, value);
281 | 	}
282 | 
283 | 	public void clear() {
284 | 		p.clear();
285 | 	}
286 | 
287 | 	public Set<Entry<Object, Object>> entrySet() {
288 | 		return p.entrySet();
289 | 	}
290 | 
291 | 	public Enumeration<?> propertyNames() {
292 | 		return p.propertyNames();
293 | 	}
294 | 
295 | 	public boolean contains(Object value) {
296 | 		return p.contains(value);
297 | 	}
298 | 
299 | 	public boolean containsKey(Object key) {
300 | 		return p.containsKey(key);
301 | 	}
302 | 
303 | 	public boolean containsValue(Object value) {
304 | 		return p.containsValue(value);
305 | 	}
306 | 
307 | 	public Enumeration<Object> elements() {
308 | 		return p.elements();
309 | 	}
310 | 
311 | 	public Object get(Object key) {
312 | 		return p.get(key);
313 | 	}
314 | 
315 | 	public boolean isEmpty() {
316 | 		return p.isEmpty();
317 | 	}
318 | 
319 | 	public Enumeration<Object> keys() {
320 | 		return p.keys();
321 | 	}
322 | 
323 | 	public Set<Object> keySet() {
324 | 		return p.keySet();
325 | 	}
326 | 
327 | 	public void list(PrintStream out) {
328 | 		p.list(out);
329 | 	}
330 | 
331 | 	public void list(PrintWriter out) {
332 | 		p.list(out);
333 | 	}
334 | 
335 | 	public void load(InputStream inStream) throws IOException {
336 | 		p.load(inStream);
337 | 	}
338 | 
339 | 	public void loadFromXML(InputStream in) throws IOException,
340 | 			InvalidPropertiesFormatException {
341 | 		p.loadFromXML(in);
342 | 	}
343 | 
344 | 	public Object put(Object key, Object value) {
345 | 		return p.put(key, value);
346 | 	}
347 | 
348 | 	public void putAll(Map<? extends Object, ? extends Object> t) {
349 | 		p.putAll(t);
350 | 	}
351 | 
352 | 	public Object remove(Object key) {
353 | 		return p.remove(key);
354 | 	}
355 | 
356 | 	/** @deprecated */
357 | 	public void save(OutputStream out, String comments) {
358 | 		p.save(out, comments);
359 | 	}
360 | 
361 | 	public int size() {
362 | 		return p.size();
363 | 	}
364 | 
365 | 	public void store(OutputStream out, String comments) throws IOException {
366 | 		p.store(out, comments);
367 | 	}
368 | 
369 | 	public void storeToXML(OutputStream os, String comment, String encoding)
370 | 			throws IOException {
371 | 		p.storeToXML(os, comment, encoding);
372 | 	}
373 | 
374 | 	public void storeToXML(OutputStream os, String comment) throws IOException {
375 | 		p.storeToXML(os, comment);
376 | 	}
377 | 
378 | 	public Collection<Object> values() {
379 | 		return p.values();
380 | 	}
381 | 	
382 | 	public String toString() {
383 | 		return p.toString();
384 | 	}
385 | 
386 | 	private static boolean isBlankString(String value) {
387 | 		return value == null || "".equals(value.trim());
388 | 	}
389 | 	
390 | 	private static String[] tokenizeToStringArray(String str,String seperators) {
391 | 		StringTokenizer tokenlizer = new StringTokenizer(str,seperators);
392 | 		List result = new ArrayList();
393 | 		
394 | 		while(tokenlizer.hasMoreElements()) {
395 | 			Object s = tokenlizer.nextElement();
396 | 			result.add(s);
397 | 		}
398 | 		return (String[])result.toArray(new String[result.size()]);
399 | 	}
400 | 	
401 | 	private static int[] toIntArray(String[] array) {
402 | 		int[] result = new int[array.length];
403 | 		for(int i = 0; i < array.length; i++) {
404 | 			result[i] = Integer.parseInt(array[i]);
405 | 		}
406 | 		return result;
407 | 	}
408 | }
409 | 


--------------------------------------------------------------------------------