Developing Persistence Architectures Using EclipseLink Database Web Services, Release 2.5
Beta Draft: 2013-04-15
EclipseLink DBWS provides Java EE-compliant, client-neutral access to relational database artifacts via a Web service. EclipseLink DBWS extends EclipseLink's core capabilities while leveraging its existing ORM and OXM components.
EclipseLink DBWS includes two parts
A design-time component, the
DBWSBuilder command-line utility, that generates the necessary deployment artifacts.
A runtime provider component that takes a service descriptor (along with related deployment artifacts) and realizes it as a JAX-WS 2.0 Web service. The runtime provider uses EclipseLink to bridge between the database and the XML SOAP Messages used by Web service clients.
An EclipseLink DBWS service may include any number of the following operations:
insert – inserts into the database persistent entities described by an XML document.
update – updates database persistent entities described by an XML document.
delete – removes from the database persistent entities described by an XML document.
query – retrieves from the database persistent entities described by an XML document.
Selection criteria for Query operations can be specified by:
SQL SELECT statement
Stored Procedure invocation
EclipseLink Named Query (that can use the complete range of EclipseLink ORM Expression Framework APIs)
The XML documents used by an operation conform to an XML Schema Definition (
This chapter includes the following sections: