|
|
(9 intermediate revisions by the same user not shown) |
Line 1: |
Line 1: |
− | ==DBWSBuilder API==
| + | For "Using DBWSBuilder API," see http://www.eclipse.org/eclipselink/documentation/2.4/dbws/overview002.htm |
− | <onlyinclude>
| + | |
− | The EclipseLink DBWS design-time utility - <tt>DBWSBuilder</tt> - is a Java application that generates EclipseLink DBWS files and assembles them into deployable archives. <br />
| + | |
− | It is normally invoked from the command-line via its <code>main</code> method:
| + | |
− | <css>
| + | |
− | .source-text {padding: 1em; border: 1px solid; color: black; background-color: #ffffff; line-height: 1.1em;}
| + | |
− | </css>
| + | |
− | <source lang="text">
| + | |
− | prompt > dbwsbuilder.cmd -builderFile {path_to_builder.xml} -stageDir {path_to_stageDir} -packageAs {packager}
| + | |
− | </source>
| + | |
− | The the given builder XML file is parsed:
| + | |
− | <css>
| + | |
− | .source-xml {padding: 1em; border: 1px solid; color: black; background-color: #ffffff; line-height: 1.1em;}
| + | |
− | </css>
| + | |
− | <source lang="xml">
| + | |
− | <?xml version="1.0" encoding="UTF-8"?>
| + | |
− | <dbws-builder xmlns:xsd="http://www.w3.org/2001/XMLSchema"
| + | |
− | <properties>
| + | |
− | <property name="projectName">test</property>
| + | |
− | <property name="driver">oracle.jdbc.OracleDriver</property>
| + | |
− | <property name="password">tiger</property>
| + | |
− | <property name="url">jdbc:oracle:thin:@localhost:1521:ORCL</property>
| + | |
− | <property name="username">scott</property>
| + | |
− | </properties>
| + | |
− | <table
| + | |
− | catalogPattern="%"
| + | |
− | schemaPattern="SCOTT"
| + | |
− | tableNamePattern="EMP"
| + | |
− | />
| + | |
− | </dbws-builder>
| + | |
− | </source>
| + | |
− | | + | |
− | You can also set the <tt>DBWSBuilder</tt>’s properties, add table or procedure definitions and SQL operations programmatically through <tt>DBWSBuilder</tt>’s API.
| + | |
− | | + | |
− | The class <b><code>org.eclipse.persistence.tools.dbws.DBWSBuilder</code></b> is public and can be populated programmatically through property setters (i.e. <b><code>setDriver()</code></b>, <b><code>setUrl()</code></b>) and adding table or procedure definitions via the public <b><code>addDbTable()</code></b> and <b><code>addDbStoredProcedure()</code></b> methods; SQL operations via <b><code>addSqlOperation()</code></b> (NB - before adding a table or procedure definition, it is recommended that the public <b><code>checkTables()</code></b> and <b><code>checkStoredProcedures()</code></b> methods be used to ensure that the definitions are supported). Once all the data and definitions have been set, the builder is invoked through the <b><code>build(...)</code></b> method:
| + | |
− | | + | |
− | <source lang="java">
| + | |
− | public void build(OutputStream dbwsSchemaStream, OutputStream dbwsSessionsStream,
| + | |
− | OutputStream dbwsServiceStream, OutputStream dbwsOrStream, OutputStream dbwsOxStream,
| + | |
− | OutputStream swarefStream, OutputStream webXmlStream, OutputStream wsdlStream,
| + | |
− | OutputStream codeGenProviderStream, OutputStream sourceProviderStream, Logger logger)
| + | |
− | throws WSDLException
| + | |
− | </source>
| + | |
− | | + | |
− | | + | |
− | </onlyinclude>
| + | |
− | Information pending
| + | |
| | | |
| [[Category: DBWS]] | | [[Category: DBWS]] |