What is Torque?

Torque is a persistence layer. Torque generates all the database resources required by your application and includes a runtime environment to run the generated classes.

Torqueはパーシステントレイヤーです。 Torqueは、アプリケーションに必要なデータベースリソースを生成し、生成したクラスを実行させるための実行環境を含んでいます。

Torque was developed as part of the Turbine Framework. It is now decoupled and can be used by itself. Starting with version 2.2 Turbine will use the decoupled Torque.

TorqueはTurbineフレームワークの一部として開発されました。 現在は独立し、単独で使うことができます。 バージョン2.2以降、Turbineは独立したTorqueを使うようになるでしょう。

Torque's generation tasks

Torqueが生成するタスク

Torque uses a single XML database schema to generate the SQL for your target database and Torque's Peer-based object relation model representing your XML database schema. Additionally, an HTML document describing the database can be generated if you wish to make a browseable version of the database schema.

Torqueは、ターゲットとなるデータベース用のSQLと、XMLデータベーススキーマを表現するTorqueのPeerベースのオブジェクトリレーションモデルを生成するために、ひとつのXMLデータベーススキーマを使います。 更に、データベーススキーマを閲覧可能にしたいときには、データベースについてのHTMLドキュメントを生成することができます。

Torque offers an Ant build file (build-torque.xml) which could be added to your project . It defines the following targets:
Torqueは、あなたのプロジェクトに追加することのできるAntビルドファイル(build-torque.xml)を提供しています。 以下のターゲットが定義されています。

  • sql
    generates SQL source from an XML schema describing a database structure
  • sql
    データベース構造を記述しているXMLスキーマからSQLソースを生成します。
  • doc
    generates html or xml documentation for xml schemas
  • doc
    XMLスキーマのXMLやHTMLのドキュメントを生成します。
  • create-db
    generates simple scripts for creating databases on various platforms.
  • create-db
    様々なプラットフォーム上のデータベースを作成する簡単なスクリプトを生成します。
  • datadtd
    generates data DTD from an XML schema describing a database structure
  • datadtd
    データベース構造を記述しているXMLスキーマからデータのDTDを生成します。
  • datadump
    dumping data from db into XML
  • datadump
    データベースからデータをXML形式でダンプします。
  • datasql
    generates SQL source from an XML data file
  • datasql
    XMLデータファイルからSQLソースを生成します。
  • jdbc
    generates an XML schema of an existing database from JDBC metadata
  • jdbc
    JDBCメタデータから現在のデータベースのXMLスキーマを生成します。
  • om
    generates output by using Velocity
  • om
    Velocityを用いてアウトプットを生成します。
  • insert-sql
    inserts a SQL file into its designated database
  • insert-sql
    指定されたデータベースにSQLファイルを挿入します。
  • sql2xml
    generates an xml schema from an sql schema
  • sql2xml
    SQLスキーマからXMLスキーマを生成します。
  • id-table-init-sql
    generates the initialization sql for the id table
  • id-table-init-sql
    idテーブルを初期化するSQLを生成します。

Torque's runtime environment

Torqueの実行時環境

Torque's runtime environment includes everything you need to use the generated OM/Peer classes. It includes a jdbc connection pool.

Torqueの実行環境は、生成されたOM/Peerクラスを使用するために必要なものすべてを含んでいます。これにはJDBCコネクションプールも含まれます。

Supported RDBMS

RDBMS driver status tester
Axion org.axiondb.jdbc.AxionDriver alpha
alpha
Martin Poeschl
Cloudscape COM.cloudscape.core.JDBCDriver untested
未テスト
DB2 COM.ibm.db2.jdbc.{app|net}.DB2Driver untested
未テスト
DB2/AS400 com.ibm.as400.access.AS400JDBCDriver possible case-insensitivity issues
大文字/小文字の区別に関する問題があるかもしれません
Scott Weaver
Hypersonic org.hsql.jdbcDriver untested
未テスト
Informix ??? untested
未テスト
InstantDB org.enhydra.instantdb.jdbc.idbDriver untested
未テスト
Interbase interbase.interclient.Driver untested
未テスト
MS SQL com.microsoft.jdbc.sqlserver.SQLServerDriver untested
未テスト
Mysql org.gjt.mm.mysql.Driver no known problems
問題なし
Martin Poeschl
Oracle oracle.jdbc.driver.OracleDriver no known problems
問題なし
Martin Poeschl
Postgres org.postgresql.Driver no known problems
問題なし
Martin Poeschl
SapDB com.sap.dbtech.jdbc.DriverSapDB untested
未テスト
Sybase com.sybase.jdbc2.jdbc.SybDriver JDBCToXMLSchema task will not generate the schema properly. All other tests pass.
JDBCToXMLSchemaタスクがスキーマを正しく生成しない。その他、問題なし
Jeffrey D. Brekke
Weblogic weblogic.jdbc.pool.Driver untested
未テスト

If your RDBMS is not listed here, please read the document about writing DB Adapters

ここに載っていないRDBMSについては、writing DB Adaptersを読んで下さい。

If there is no tester for your RDBMS and you want to help, please read the developer-guide, run the tests and send your results (and bugfixes ;) to the turbine-dev list.

テスターが存在しないRDBMSのテストの手助けをしたい場合には、developer-guideを読んで下さい。 そして、テストを実行し、その結果をturbine-dev listへ送って下さい。