Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "EclipseLink/UserGuide/DBWS/Overview/Design time"
Line 54: | Line 54: | ||
|<tt>-packageAs[:archive_flag]</tt> | |<tt>-packageAs[:archive_flag]</tt> | ||
|Required | |Required | ||
− | |{packager} [warFilename] - type of packager to use to build the deployment archive.<br/>The optional archive_flag allows one to create an 'exploded directory' view of the archive. If the optional <tt>[warFilename]<tt> is not provided, then the name of the archive is based on the name of the project. If the packager does not exist, then the usage message above is displayed with the list of supported packagers: | + | |{packager} [warFilename] - type of packager to use to build the deployment archive.<br/>The optional archive_flag allows one to create an 'exploded directory' view of the archive. If the optional <tt>[warFilename]</tt> is not provided, then the name of the archive is based on the name of the project. If the packager does not exist, then the usage message above is displayed with the list of supported packagers: |
− | * jdev - generate the deployment files (source only, no <tt>.class</tt> files) in an 'exploded directory' view compatible with the layout of a JDev project | + | * <tt>jdev</tt> - generate the deployment files (source only, no <tt>.class</tt> files) in an 'exploded directory' view compatible with the layout of a JDev project |
− | * javase - generate a <tt>.jar</tt> file that can run in Javase6 'containerless' mode using the [http://java.sun.com/javase/6/docs/api/javax/xml/ws/Endpoint.html javax.xml.ws.Endpoint API] | + | * <tt>javase</tt> - generate a <tt>.jar</tt> file that can run in Javase6 'containerless' mode using the [http://java.sun.com/javase/6/docs/api/javax/xml/ws/Endpoint.html javax.xml.ws.Endpoint API] |
− | * wls - generate a <tt>.war</tt> file compatible with WebLogic application server (10.3.4 or higher) | + | * <tt>wls</tt> - generate a <tt>.war</tt> file compatible with WebLogic application server (10.3.4 or higher) |
− | * glassfish - generate a <tt>.war</tt> file compatible with Glassfish application server (3.0.1 or higher) | + | * <tt>glassfish</tt> - generate a <tt>.war</tt> file compatible with Glassfish application server (3.0.1 or higher) |
− | * jboss - generate a <tt>.war</tt> file compatible with JBoss application server (6.0 or higher) | + | * <tt>jboss</tt> - generate a <tt>.war</tt> file compatible with JBoss application server (6.0 or higher) |
− | * war - generate a <tt>.war</tt> file (testing only) | + | * <tt>war</tt> - generate a <tt>.war</tt> file (testing only) |
− | * was - generate a <tt>.war</tt> file compatible with WebSphere application server (7.0 or higher) | + | * <tt>was</tt> - generate a <tt>.war</tt> file compatible with WebSphere application server (7.0 or higher) |
− | * eclipse - generate the deployment files (source only, no <tt>.class</tt> files) in an 'exploded directory' view compatible with the layout of an Eclipse project | + | * <tt>eclipse</tt> - generate the deployment files (source only, no <tt>.class</tt> files) in an 'exploded directory' view compatible with the layout of an Eclipse project |
</source> | </source> | ||
|} | |} |
Revision as of 18:21, 7 December 2011
EclipseLink DBWS
EclipseLink | |
Website | |
Download | |
Community | |
Mailing List • Forums • IRC • mattermost | |
Issues | |
Open • Help Wanted • Bug Day | |
Contribute | |
Browse Source |
Creating EclipseLink DBWS Services using the DBWSBuilder utility
The EclipseLink DBWS design-time utility DBWSBuilder is a Java application that processes an EclipseLink DBWS builder XML file to produce a deployable archive (typically a .war file) containing all the required deployment artifacts (WSDL, .xsd schema, web.xml, etc.) for a JAX-WS 2.0 compliant Web Service. There are script files provided for invoking DBWSBuilder. They are located in the <ECLIPSELINK_HOME>\utils\dbws directory. The scripts ending in .cmd are for Windows use while those that end with .sh are for all other operating systems. Before running the dbwsbuilder.cmd script, please ensure that the following environment variables in the <ECLIPSELINK_HOME>\utils\dbws\setenv.cmd (or setenv.sh file) are set:
- JAVA_HOME
- DRIVER_CLASSPATH
DBWSBuilder Command-line arguments
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] -packageAs:[default=archive] glassfish [warFilename] -packageAs:[default=archive] jboss [warFilename] -packageAs:[default=archive] war [warFilename] -packageAs:[default=archive] was [warFilename] -packageAs:[default=not supported] eclipse
Argument | Status | Description |
---|---|---|
-builderFile | Required | {path_to_dbws_builder.xml} - location of dbws_builder.xml file
If the file does not exist, then a brief message is displayed: DBWSBuilder unable to locate dbws-builder.xml file c:\foo\bar.xml |
-stageDir | Required | {path_to_stageDir} - directory to use for staging output
If the directory does not exist, then a brief message is displayed: DBWSBuilder unable to locate stage directory c:\temp\blah |
-packageAs[:archive_flag] | Required | {packager} [warFilename] - type of packager to use to build the deployment archive. The optional archive_flag allows one to create an 'exploded directory' view of the archive. If the optional [warFilename] is not provided, then the name of the archive is based on the name of the project. If the packager does not exist, then the usage message above is displayed with the list of supported packagers:
</source> |
Typical .war file layout:
root of war file \---WEB-INF | | web.xml | +---classes | +---META-INF | | eclipselink-dbws.xml | | eclipselink-dbws-or.xml | | eclipselink-dbws-ox.xml | | eclipselink-dbws-sessions.xml | | | \---_dbws | DBWSProvider.class -- auto-generated JAX-WS 2.0 Provider | ProviderListener.class -- auto-generated Servlet Listener | \---wsdl eclipselink-dbws-schema.xsd eclipselink-dbws.wsdl swaref.xsd -- optional
File | Description |
---|---|
web.xml | The Web application deployment file (required for deployment as a JAX-WS Web service - see JSR-109 for more details). |
eclipselink-dbws.xml | The EclipseLink DBWS service descriptor file (described in the EclipseLink User Guide). |
eclipselink-dbws-or.xml | The EclipseLink ORM project XML file. For more information, see Introduction to Relational Projects (ELUG). |
eclipselink-dbws-ox.xml | The EclipseLink OXM project XML file. For more information, see Introduction to XML Projects (ELUG). |
eclipselink-dbws-sessions.xml | The EclipseLink sessions.xml file for the EclipseLink DBWS service. It contains references to the EclipseLink ORM and OXM project XML files. For more information, see Introduction to EclipseLink Sessions (ELUG). |
eclipselink-dbws-schema.xsd | Contains XML type definitions for operation arguments and return types. The DBWSBuilder utility automatically generates this file from database metadata to derive element-tag names and types. |
eclipselink-dbws.wsdl | Contains entries for all operations in the EclipseLink DBWS service. (required for deployment as a JAX-WS Web service - see JSR-109 for more details). |
swaref.xsd | (optional) Contains XML type definitions for SOAP attachments. |
Note that the files swaref.xsd and web.xml have names and content determined by their roles in Web deployment and cannot be changed.