Changes between Initial Version and Version 1 of torque

Timestamp:

12/15/2011 05:40:51 PM (14 years ago)

Author:

xiejing

Comment:

--

torque

@@ +1 @@
+== '''torque详细配置''' ==
+ Torque是Apache的公开源代码项目，最开始是Turbine框架的组成部分，后面被独立出来作为一个单独的组件，归入了Apache的DB项目下。Torque的主要功能是实现对数据库的访问，Torque 主要包含两部分：一部分是 Generator，它通过使用xml配置文件，产生应用程序访问数据库的资源，包括创建数据库、表和初始化sql 语句和 java 文件；另外一部分是 Runtime，提供使用这些代码访问数据库的运行时环境。
+        ORM(Object Relational Mapping,对象角色建模
+        torque各版本之间的差距还是挺大的，本文以torque3.3的配置为例
+        http://db.apache.org/torque/download.html下载torque-gen-3.3.zip，torque-3.3.zip。
+
+        torque-gen-3.3.zip主要有torque-gen-3.3.jar，build.properties，default.properties和build-torque.xml。torque-gen-3.3.jar自然是提供Generator运行是的包支持，build-torque.xml是ant的运行文件，它读取了build.properties和default.properties两个配置文件，这两个properties设置了生成访问数据库需要的资源文件和java代码需要用到的环境变量。存储数据库系统的属性，主要有项目名称、数据库类型、数据库链接URL、Driver、用户名、密码及主机名等。
+        torque-3.3.zip解压后有torque-3.3.jar和Torque.properties，torque-3.3.jar提供torque运行时的包支持，Torque.properties是toorque访问数据库时初始化环境需要用到的一些配置内容。
+
+        综上，核心的配置文件为：
+        A. build.properties
+        B. *-schema.xml、id-table-schema.xml
+        C. Torque.properties 
+        D. 一般还会有一个defalt.properties
+
+        E. build-torque.xml 这个是ant的配置文件，参照这个就可了解到以上四个配置文件的作用
+
+        id-table-schema.xml是Torque的IDBroker服务调用，用于指导Torque生成id_table表，他保存了project-schema.xml中相关ID自动增长的相关内容，实现类似于Oracle中的Sequence的功能。
+
+        torque Genarator的核心任务，可以详细参照build-torque.xml的配置，列举默认常用的如下：
+(1).sql 解析%Torque_home%/schema/＊.xml，生成对应的$Torque_home/src/sql/＊.sql文件；   
+(2).doc 解析%Torque_home%/schema/＊.xml，生成对应的$Torque_home/src/sql/＊.html文件，描述数据库结构；   
+(3).create-db 生成不同平台上产生数据库系统的脚本；   
+(4).insert-sql 执行%Torque_home%/schema/＊-schema.sql文件到指定数据库；   
+(5).sql2xml 解析%Torque_home%/schema/schema.sql文件，产生Torque对应的数据库文件%Torque_home%/schema/schema.xml；   
+(5).id-table-init-sql 根据%Torque_home%/schema/id-table-schema.xml文件产生id表的初始化脚本文件；
+
+ANT的运行命令为%Torque_home%/ant -f build-torque.xml $taskname
+
+ant -f build-torque.xml   
+ant -f build-torque.xml create-db   
+ant -f build-torque.xml id-table-init-sql   
+ant -f build-torque.xml insert-sql
+
+//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+         实际使用过程中，实际上没必要一定使用torque默认的文件夹结构（即：%Torque%\src\schema)，因为所有工作都是有Ant完成的，文件夹的位置也都是在build-torque.xml值指定的。当然，如果你不打算修改build-torque.xml的话，就要使用torque默认的结构和要求的文件名格式。
+
+         Torque 3.3 为例：
+
+build.properties文件：
+#工程名称
+torque.project = torque
+#数据库类型
+torque.database = mysql
+
+torque.addGetByNameMethod = true
+torque.addIntakeRetrievable = false
+torque.addSaveMethod = true
+torque.addTimeStamp = true
+torque.basePrefix = Base
+torque.complexObjectModel = true
+torque.useClasspath = true
+torque.useManagers = false
+torque.objectIsCaching = true
+torque.silentDbFetch = true
+torque.generateBeans = false
+torque.beanSuffix = Bean
+torque.enableJava5Features = false
+
+#数据库URL，注意数据库名应该和工程名保持一致
+torque.database.createUrl = jdbc:mysql://localhost:3306/mydb
+torque.database.buildUrl = jdbc:mysql://localhost:3306/torque
+torque.database.url = jdbc:mysql://localhost:3306/torque
+#数据库驱动类
+torque.database.driver = com.mysql.jdbc.Driver
+#连接数据库使用的用户名
+torque.database.user = root
+#连接数据库使用的密码
+torque.database.password = 229229
+#数据库的主机IP
+torque.database.host = 127.0.0.1
+torque.sameJavaName = false
+
+||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
+
+project-schema.xml：
+随便建了一个最简单的表为例：
+
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE database SYSTEM "http://db.apache.org/torque/dtd/database_3_3.dtd">
+
+<database name="torque" defaultIdMethod="idbroker">
+    <table name="user" description="User Table">
+        <column name="id" required="true" primaryKey="true" type="INTEGER" description="User ID"/>
+        <column name="name" required="true" type="VARCHAR" size="40" description="User Name"/>
+    </table>
+</database>
+
+||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
+
+id-table-schema.xml：
+
+<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
+<!DOCTYPE database SYSTEM "http://db.apache.org/torque/dtd/database_3_3.dtd">
+
+<database name="torque">
+<table name="ID_TABLE" idMethod="idbroker">
+    <column name="ID_TABLE_ID" required="true" primaryKey="true" type="INTEGER"/>
+    <column name="TABLE_NAME" required="true" size="255" type="VARCHAR"/>
+    <column name="NEXT_ID" type="INTEGER"/>
+    <column name="QUANTITY" type="INTEGER"/>
+
+    <unique>
+      <unique-column name="TABLE_NAME"/>
+    </unique>
+
+</table>
+</database>
+这个配置文件让数据库生成一个叫做ID_TABLE的表
+
+||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
+
+torque.properties:
+
+torque.applicationRoot = .
+
+log4j.category.org.apache.torque = ALL, org.apache.torque
+log4j.appender.org.apache.torque = org.apache.log4j.FileAppender
+log4j.appender.org.apache.torque.file = ${torque.applicationRoot}/logs/torque.log
+log4j.appender.org.apache.torque.layout = org.apache.log4j.PatternLayout
+log4j.appender.org.apache.torque.layout.conversionPattern = %d [%t] %-5p %c - %m%n
+log4j.appender.org.apache.torque.append = false
+
+torque.defaults.pool.maxIdle = 8
+torque.defaults.pool.maxActive = 10
+torque.defaults.pool.timeBetweenEvictionRunsMillis= 300000
+torque.defaults.pool.minEvictableIdleTimeMillis = 3600000
+//以上部分用默认的就可以了，也就是torque-3.3.zip里面自带的
+
+//下面灰色背景部分是需要针对自己项目改动的
+torque.defaults.connection.driver = com.mysql.jdbc.Driver
+torque.defaults.connection.url = jdbc:mysql://localhost:3306/torque
+torque.defaults.connection.user = root
+torque.defaults.connection.password = 229229
+
+torque.database.default=torque
+torque.database.torque.adapter=mysql
+
+# # Using commons-dbcp
+torque.dsfactory.torque.factory=org.apache.torque.dsfactory.SharedPoolDataSourceFactory
+torque.dsfactory.torque.pool.maxIdle=8
+torque.dsfactory.torque.pool.maxActive=10
+torque.dsfactory.torque.pool.testOnBorrow=true
+torque.dsfactory.torque.pool.validationQuery=SELECT 1
+torque.dsfactory.torque.connection.driver = com.mysql.jdbc.Driver
+torque.dsfactory.torque.connection.url = jdbc:mysql://localhost:3306/torque
+torque.dsfactory.torque.connection.user = root
+torque.dsfactory.torque.connection.password = 229229
+
+torque.idbroker.clever.quantity=true
+torque.manager.useCache = true
+
+||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
+
+defalt.properties:
+我使用的是wdw.properties配置文件，需要在build.xml中改动一下，将default.properties的路径改为wdw.properties文件路径即可
+
+torque.home = .
+
+#指定了生成Java文件的包路径
+torque.targetPackage = javaTorque.wdwtest
+torque.runOnlyOnSchemaChange = false
+
+torque.output.dir = ${torque.home}/src
+torque.schema.dir = ${torque.home}/src/schema
+torque.templatePath = templates
+torque.useClasspath = true
+
+torque.doc.dir = ${torque.output.dir}/doc
+torque.java.dir = ${torque.output.dir}
+torque.java.base.dir = ${torque.java.dir}
+torque.javadoc.dir = ${torque.output.dir}/javadoc
+torque.ojb.dir = ${torque.output.dir}/ojb
+torque.sql.dir = ${torque.output.dir}/sql
+torque.omzip.dir = ${torque.output.dir}
+
+torque.database.manualCreation = false
+torque.saveJavaName = false
+
+torque.addGetByNameMethod = true
+torque.addIntakeRetrievable = false
+torque.retrievableInterface = org.apache.turbine.om.Retrievable
+torque.addSaveMethod = true
+torque.addTimeStamp = true
+torque.basePrefix = Base
+torque.complexObjectModel = true
+torque.saveException = Exception
+torque.useClasspath = false
+# Whether to generate Manager classes for JCS-based caching.
+torque.useManagers = false
+torque.objectIsCaching = true
+torque.silentDbFetch = true
+torque.generateBeans = false
+torque.beanSuffix = Bean
+
+torque.subpackage.base.bean = bean
+torque.subpackage.bean = bean
+torque.subpackage.map = map
+
+torque.omzip.src.base = false
+torque.omzip.src.extension = false
+torque.omzip.bin.base = false
+torque.omzip.bin.extension = false
+torque.omzip.deleteFiles = false
+
+torque.generateDeprecated = true
+
+
+torque.idTableXMLFile =
+torque.initialID = 101
+torque.initialIDValue = 1000
+torque.initialIDStep = 10
+
+# Doc settings
+torque.doc.format = html
+torque.doc.html.normalFont = font-family: Verdana; font-size: 10pt;
+torque.doc.html.fkColor = afe295
+
+torque.template.sql = sql/base/Control.vm
+torque.template.om = om/Control.vm
+torque.template.om.base = om/ControlBase.vm
+torque.template.idTable = sql/id-table/Control.vm
+torque.template.dataDtd = data/Control.vm
+torque.template.dataDump = data/dump/Control.vm
+torque.template.dataSql = sql/load/Control.vm
+torque.template.doc = doc/Control.vm
+torque.template.sqlDbInit = sql/db-init/Control.vm
+torque.template.ojb = ojb/repository/Control.vm
+torque.template.ojbModel = ojb/model/Control.vm
+
+torque.compile.src.dir = ${torque.java.dir}
+torque.compile.build.dir = bin/classes
+torque.compile.debug = on
+torque.compile.deprecation = off
+torque.compile.optimize = off
+
+torque.schema.sql.includes = *-schema.xml
+torque.schema.sql.excludes =
+torque.schema.doc.includes = *-schema.xml
+torque.schema.doc.excludes =
+torque.schema.create-db.includes = *-schema.xml
+torque.schema.create-db.excludes =
+torque.schema.init-sql.includes = *-schema.xml
+torque.schema.init-sql.excludes = id-table-schema.xml
+torque.schema.om.includes = *-schema.xml
+torque.schema.om.excludes = id-table-schema.xml
+torque.schema.ojb.includes = *-schema.xml
+torque.schema.ojb.excludes =
+