.. include:: ../services/mysql.rst

.. highlight:: java

API使用手册
===========

SAE上的MySQL服务和普通MySQL服务几乎一样。

.. note::

   MySQL服务在拿到连接10秒内未做操作将会自动丢失，所以在配置数据库连接池时候特别需要注意如maxIdleTime等配置的大小，目前Java平台使用较多数据库连接池是c3p0和dbcp

使用示例
============

在Java应用中使用SAE提供的MySQL服务很简单，你就像使用普通的MySQL一样即可，当然你需要开启MySQL服务，同时把URL、端口、用户名和密码等信息修改一下 ::

    用 户 名 :  accesskey(应用的accesskey)
    密　　码 :  secretkey(应用的secretkey)
    主库域名 :  w.rdc.sae.sina.com.cn
    从库域名 :  r.rdc.sae.sina.com.cn
    端　　口 :  3307
    数据库名 :  app_appname(app_加上应用名称)

SAE的MySQL数据库提供了主从数据库，我们可以向主数据库写数据，同时从从库里面读取数据。你可以使用原生态的JDBC来操作数据库，同样你也可以使用hibernate这种持久层框架来操作数据库。
下面给出两个JDBC操作数据库的例子 :: 

    // 使用主库写数据 使用SaeUserInfo提供的静态方法获取应用的AccessKey和SecretKey
    String URL="jdbc:mysql://w.rdc.sae.sina.com.cn:3307/app_myappname";
    String username=SaeUserInfo.getAccessKey();
    String password=SaeUserInfo.getSecretKey();
    String driver="com.mysql.jdbc.Driver";
    Class.forName(driver).newInstance();
    Connection con=DriverManager.getConnection(url,username,password);
    
    // 使用从库读数据
    String URL="jdbc:mysql://r.rdc.sae.sina.com.cn:3307/app_myappname";
    // 通过SaeUserInfo提供的静态方法获取应用的access_key和secret_key
    String Username=SaeUserInfo.getAccessKey();
    String Password=SaeUserInfo.getSecretKey();
    String Driver="com.mysql.jdbc.Driver";
    Class.forName(Driver).newInstance();
    Connection con=DriverManager.getConnection(URL,Username,Password);