一次做应用升级出现了一个问题，描述如下： 升级分为两块，一块是数据库结构变更（表结构增加新字段）;一块是应用程序的升级。 应用环境为：jboss4.

一次做应用升级出现了一个问题，描述如下：
   升级分为两块，一块是数据库结构变更（表结构增加新字段）;一块是应用程序的升级。
   应用环境为：jboss4.0.5 +　ibatis + spring 数据源在jboss的oracle-ds.xml文件中进行配置，通过spring的jndi方式进行查找 。
   我先将数据库进行升级，更改表结构（增加字段），因为应用中的ibatis的查询采用的是ResultMap返回方式，返回定义的表结构字段，即使数据库发生变更，也不会产生影响。于是我大胆的进行脚本的执行。结果当我下午16:00数据库变更之后，几乎在同时就有人反应应用的一些查询功能无法使用，立刻查看出错日志：
Java代码  收藏代码

       Caused by: com.alibaba.generalorm.dao.DataAccessException: Data query error!    
    --- The error occurred in sqlmap/CiaDissension.xml.   
    --- The error occurred while applying a parameter map.   
    --- Check the QUERY_ALL_DISSENSION_CATEGORY-InlineParameterMap.   
    --- Check the statement (query failed).   
    --- Cause: java.sql.SQLException: OALL8 处于不一致状态 
        at com.alibaba.ibatis.BasicIBatisDao.query(BasicIBatisDao.java:315) 
        at com.alibaba.china.rcc.riskdc.dao.DissensionCategoryDAO.getAll(DissensionCategoryDAO.java:40) 
        at com.alibaba.china.rcc.riskdc.service.impl.DissensionServiceImpl.getCategoryMap(DissensionServiceImpl.java:495) 
        at com.alibaba.china.rcc.riskdc.service.impl.DissensionServiceImpl.getCategory(DissensionServiceImpl.java:188) 
        at com.alibaba.china.rcc.riskdc.web.action.DissensionAction.getCategory(DissensionAction.java:263) 
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) 
        at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39) 
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25) 
        at java.lang.reflect.Method.invoke(Method.java:597) 
        at com.alibaba.webx.action.invoker.AbstractModuleMethodInvoker.executeNoArgMethod(AbstractModuleMethodInvoker.java:401) 
        ... 33 more 


Java代码  收藏代码

       Caused by: com.alibaba.generalorm.dao.DataAccessException: Data query error!    
    --- The error occurred in sqlmap/CiaDissension.xml.   
    --- The error occurred while applying a parameter map.   
    --- Check the QUERY_ALL_DISSENSION_BUSINESS-InlineParameterMap.   
    --- Check the statement (query failed).   
    --- Cause: java.sql.SQLException: 违反协议 
        at com.alibaba.ibatis.BasicIBatisDao.query(BasicIBatisDao.java:315) 
        at com.alibaba.china.rcc.riskdc.dao.DissensionBusinessDAO.getAll(DissensionBusinessDAO.java:19) 
        at com.alibaba.china.rcc.riskdc.service.impl.DissensionServiceImpl.getBusiness(DissensionServiceImpl.java:178) 
        at com.alibaba.china.rcc.riskdc.web.action.DissensionAction.getBusiness(DissensionAction.java:249) 
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) 
        at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39) 
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25) 
        at java.lang.reflect.Method.invoke(Method.java:597) 
        at com.alibaba.webx.action.invoker.AbstractModuleMethodInvoker.executeNoArgMethod(AbstractModuleMethodInvoker.java:401) 
        ... 33 more 


为什么会出现违反协议的问题？马上google一下，有些人说是因为数据库的字段类型与java中使用的类型不一致导致，但查看了ibtais的map文件，老的应用代码根本还没有使用新的的字段！后来找pla共同排查，也没有发现应用程序哪里会出现问题，便打电话给DBA让他查下数据库，DBA咨询了一位资格较老的DBA，他说以前也出现过这种情况，只要将应用重启下，就好了。马上重启，果然问题解决了，违反协议的错误没有再报。

查找原因：
在做升级前，我自己在开发环境也做过模拟，并没有出现如果应用不重启，数据库变更而报“违反协议”的错误。而我看了下发布环境与开发环境差异，唯一的差异是开发环境没有采用jboss+jndi的方式获取数据源，而采用了tomcat+c3p0的方式获取数据源。

于是我开始实验。
Tomcat+C3P0启动方式:
1.准备好更改数据库脚本。
2.在开发环境用tomcat启动应用，并访问到涉及表结构变更的页面。
3.执行数据库脚本，确保表结构发生了变更。
4.刷新在步骤2的页面，查看后台输出和前台页面输出。
5.一切正常，没有抛出违反协议或处于不一致状态的错误日志。
JBoss4.0.5+JNDI启动方式
1.准备好更改数据库脚本。
2.在开发环境用jboss启动应用，并访问到涉及表结构变更的页面。
3.执行数据库脚本，确保表结构发生了变更。
4.刷新在步骤2的页面，查看后台输出和前台页面输出。
5.出现了违反协议和处于不一致状态的问题。

总结：

由此可以看出，出现这个问题与ibatis没有关系，而与数据源的获取方式有关，一种是通过Spring+c3p0直接注入DataSource;一种是在oracle-ds.xml文件中配置，然后在spring中通过jndi的方式进行查找，获取数据源。第二种在数据库变更的情况下，就必须进行应用重启，否则就会抛出违反协议或处于不一致的状态。

但根本原因到底是什么呢？我还在寻找。
===================================================
咨询了大少，并不是因为数据源配置模式没有关系，用c3p0或者jndi等，而是与数据源的配置方式有关：

在oracle-ds的配置如下：
Java代码  收藏代码

    <local-tx-datasource> 
         <jndi-name>rccBopsDataSource</jndi-name> 
         <use-java-context>false</use-java-context> 
         <connection-url>jdbc:oracle:thin:@xx.xx.xx.xx:1521:xx</connection-url> 
         <connection-property name="SetBigStringTryClob">true</connection-property> 
         <connection-property name="defaultRowPrefetch">50</connection-property> 
         <connection-property name="clientEncoding">GBK</connection-property> 
         <connection-property name="serverEncoding">ISO-8859-1</connection-property> 
         <driver-class>com.alibaba.china.jdbc.SimpleDriver</driver-class> 
         <min-pool-size>1</min-pool-size> 
         <max-pool-size>14</max-pool-size> 
         <prepared-statement-cache-size>20</prepared-statement-cache-size> 
         <metadata> 
             <type-mapping>Oracle9i</type-mapping> 
         </metadata> 
         <idle-timeout-minutes>15</idle-timeout-minutes> 
         <exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name> 
         <user-name>xx</user-name> 
         <password>xx</password> 
     </local-tx-datasource> 



其中prepared-statement-cache-size参数解释为：
<prepared-statement-cache-size> - the number of prepared statements per connection to be kept open and reused in subsequent requests. They are stored in a LRU cache. The default is 0 (zero), meaning no cache.
为每个打开的数据库连接缓存了一定数量的prepared statement.他们是存在LRU cache中，如果设值为0,那么将不缓冲。这里我们设值了每个连接缓存20条prepared statment。

而在c3p0的配置中：
Xml代码  收藏代码

     <bean id="testDataSource" 
    class="org.springframework.beans.factory.config.MethodInvokingFactoryBean"> 
    <property name="staticMethod"> 
        <value>com.mchange.v2.c3p0.DataSources.pooledDataSource</value> 
    </property> 
    <property name="arguments"> 
        <list> 
            <ref local="unpooledDataSource" /> 
            <props> 
                <prop key="acquireIncrement">1</prop> 
                <prop key="initialPoolSize">1</prop> 
                <prop key="minPoolSize">1</prop> 
                <prop key="maxPoolSize">5</prop> 
                <prop key="maxIdleTime">1800</prop>                  
                <prop key="maxIdleTimeExcessConnections">1000</prop> 
                <!-- 自动收缩连接用的,单位秒 --> 
                <!-- 自动重连需要的三个参数 --> 
                <prop key="acquireRetryAttempts">30</prop> 
                <prop key="acquireRetryDelay">1000</prop> 
                <prop key="breakAfterAcquireFailure">false</prop> 
                <!-- 获取一个connection需要的时间，单位毫秒 --> 
                <prop key="checkoutTimeout">5000</prop> 
            </props> 
        </list> 
    </property> 
    lt;/bean> 


上网查了下，影响到preparedStatment cache的参数有两个：maxStatements和maxStatementsPerConnection 如果maxStatements与maxStatementsPerConnection均为0，则缓存被关闭，默认为0。

继续实验：

1、将c3p0配置增加maxStatements和maxStatementsPerConnection并都设值20。
修改数据库表结构，刷新访问页面。
后台抛出违反协议和处于不一致状态的错误提示。

2.将oracle-ds.xml文件配置更改prepared-statement-cache-size为0。
修改数据库表结构，刷新访问页面。
后台没有抛出违反协议和处于不一致状态的错误提示。

附参考文章：

http://community.jboss.org/wiki/configdatasources   讲解jboss中关于datasource的参数
http://msq.iteye.com/blog/60387   讲解c3p0的详细参数