|
|
| (37 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| − | {{EclipseLink_UserGuide
| + | For the current version, see: |
| − | |info=y
| + | '''[http://www.eclipse.org/eclipselink/documentation/2.4/dbws/toc.htm Developing Persistence Architectures Using EclipseLink Database Web Services, Release 2.4]''' |
| − | |toc=n
| + | |
| − | |eclipselink=y
| + | |
| − | |eclipselinktype=DBWS
| + | |
| − | }}
| + | |
| | | | |
| − | == Creating EclipseLink DBWS Services using the DBWSBuilder utility ==
| |
| − | The EclipseLink DBWS design-time utility <tt><b>DBWSBuilder</b></tt> is a Java application that processes an [[EclipseLink dbws-builder.xml File (ELUG)#eclipselink-dbws-builder.xml|EclipseLink DBWS builder XML file]] to produce a deployable archive (typically a <tt>.war</tt> file) containing all the required deployment artifacts (WSDL, <tt>.xsd</tt> schema, <tt>web.xml</tt>, eclipselink-dbws-or.xml, etc). Typical <tt>.war</tt> file layout:
| |
| − | root of war file
| |
| − | \---web-inf
| |
| − | |
| |
| − | | <span style="font-weight: bold;">web.xml</span>
| |
| − | |
| |
| − | | +---META-INF
| |
| − | | | <span style="font-weight: bold;">eclipselink-dbws.xml</span>
| |
| − | | | <span style="font-weight: bold;">eclipselink-dbws-or.xml</span>
| |
| − | | | <span style="font-weight: bold;">eclipselink-dbws-ox.xml</span>
| |
| − | | | <span style="font-weight: bold;">eclipselink-dbws-sessions.xml</span>
| |
| − | | |
| |
| − | | \---_dbws
| |
| − | | <span style="font-weight: bold;">DBWSProvider.class</span> -- auto-generated JAX-WS 2.0 Provider
| |
| − | |
| |
| − | \---wsdl
| |
| − | <span style="font-weight: bold;">eclipselink-dbws-schema.xsd</span>
| |
| − | <span style="font-weight: bold;">eclipselink-dbws.wsdl</span>
| |
| − | <span style="font-weight: bold;">swaref.xsd</span> -- optional
| |
| | | | |
| − | Please ensure that the following environment variables in the <tt><ECLIPSELINK_HOME>\utils\dbws\setenv.cmd</tt> (or <tt>setenv.sh</tt> file) are set before invoking <tt>DBWSBuilder</tt>:
| + | To create EclipseLink DBWS Services using the DBWSBuilder utility, see http://www.eclipse.org/eclipselink/documentation/2.4/dbws/overview002.htm |
| − | * <tt>JAVA_HOME</tt>
| + | |
| − | * <tt>DRIVER_CLASSPATH</tt>
| + | |
| − | | + | |
| − | There are script files provided for invoking <tt>DBWSBuilder</tt>. They are located in the <tt><ECLIPSELINK_HOME>\utils\dbws</tt> directory. The scripts are <tt>dbwsbuilder.cmd</tt> for Windows use, and <tt>dbwsbuilder.sh</tt> for all other operating systems.
| + | |
| − | | + | |
| − | <source lang="text">
| + | |
| − | DBWSBuilder usage - [] indicates optional argument:
| + | |
| − | prompt > dbwsbuilder.cmd -builderFile {path_to_dbws_builder.xml} -stageDir {path_to_stageDir} -packageAs[:archive_flag - archive, noArchive, ignore] {packager} [additional args]
| + | |
| − | Available packagers:
| + | |
| − | -packageAs:[default=not supported] jdev
| + | |
| − | -packageAs:[default=archive] javase [jarFilename]
| + | |
| − | -packageAs:[default=archive] wls [warFilename] [warFilename]
| + | |
| − | -packageAs:[default=archive] glassfish [warFilename] [warFilename]
| + | |
| − | -packageAs:[default=archive] jboss [warFilename] [warFilename]
| + | |
| − | -packageAs:[default=archive] war [warFilename] [warFilename]
| + | |
| − | -packageAs:[default=archive] was [warFilename] [warFilename]
| + | |
| − | -packageAs:[default=not supported] eclipse
| + | |
| − | </source>
| + | |
