java.sql.SQLException: 违反协议异常的一种解释

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

   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

 

   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的配置如下：

<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的配置中：

 <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的详细参数