Java Emitter Template (JET) Component Projects pattern

The release of version 7.5 of the Rational Software Delivery Platform provides users of the Design Pattern Toolkit (DPTK) with equivalent functionality built into the IBM Rational modeling products. The new version of the Rational Software Delivery Platform includes new code-generation technology based on the Eclipse Modeling Framework Technologies Java Emitter Template (JET) open-source project. JET includes many technologies first demonstrated in the Design Pattern Toolkit (DPTK).

Java Emitter Template (JET) is the Rational Application Developer upgrade to the Design Pattern Toolkit (DPTK). It is an Eclipse-enabled template engine for generating applications based on customizable, model-driven architecture transformations. WebSphere Commerce uses the JET plug-in for creating WebSphere Commerce service modules from a simple XML file. By describing the service module in a specialized XML syntax, the service modules can be generated. This allows you to start directly with the service module implementation without having to spend hours with the setup and configuration of a service module.

Note: The DPTK pattern provided in WebSphere Commerce Version 6 generated a sample Delete command for a new service. However, the JET-based pattern does not generate a sample Delete command, only a Create. This update seeks to simplify what the pattern generates. If you require a Delete command, you must create a new class that extends the AbstractProcessDeleteActionUsingBusinessObjectMediatorCmdImpl class.

Component Projects Pattern Input Definition

Component Projects Pattern Input Definition
Component Projects Pattern Input Definition
Element	Attribute	Remark
commerceComponent		The root node of a service module definition.
	name	The service module name (Project).
	packagenameprefix	The package name for generated class (com.mycompany.commerce).
	namespace	The name space for the new services.
	nlsprefix	The namespace prefix that associates an element with a particular namespace. The value is generally a four-character string.
	type	Either SOI or BOD SOI: using existing task command and access beans. BOD: using new commands and DSL.
	internal	Reserved for IBM internal use.
noun		May define 1 to n of nouns under the Commerce-component element.
	name	The noun's name.
	get	Either true or false True: The noun provides `get` services. False: The noun does not provide `get` services.
	process	Either true or false.
	change	Either true or false.
	sync	Either true or false.
nounpart		May define 0 to n noun parts under each noun.
	name	The name of the noun part.
	xpath	The XPath of the noun part. For example, if a noun part name is `Description`, the XPath would be `/Description[]`

Generated files

The following files are generated when running the pattern, where:

SOI/BOD: The file is generated for either the BOD or SOI programming models. If no value is specified, the file is always generated.
Verb: The file will be generated when a noun is specified. If no value is specified, the file is always generated.
Implement: The file requires user implementation or modification.
Regenerated: The file will always be regenerated when running the pattern.

List of generated files for `ServiceModule`-Client.
The following table shows a list of generated files for `ServiceModule`-Client.
	Implement	Regenerated
`ServiceModule`-Client
`ServiceModule`Facade.java		Y
`Noun`Exception.java		Y
Abstract`ServiceModule`FacadeClient.java		Y
`ServiceModule`FacadeConstants.java	Y
`ServiceModule`FacadeClient.java	Y
External`ServiceName`FacadeConstants	Y
AbstractExternal`ServiceName`FacadeClient		Y
External`ServiceName`Client	Y

List of generated files for `ServiceModule`-DataObjects.
	Implement	Regenerated
`ServiceModule`-DataObjects
BOD and Noun XSD files	Y
`ServiceModule`Services.wsdl		Y
genmodel	Reload
ecore	Reload

List of generated files for `ServiceModule`-Server.
	SOI/BOD	Verb	Implement	Regenerated
`ServiceModule`-Server
Get`Noun`Cmd		Get
Get`Noun`CmdImpl		Get
Compose`Noun`Cmd	SOI	Get
Compose`Noun`CmdImpl	SOI	Get	Y
Fetch`Noun`Cmd		Get
Fetch`Noun`CmdImpl		Get	Y (SOI)
InsertMore`Noun`Cmd		Get
InsertMore`Noun`CmdImpl		Get	Y
Change`Noun`Cmd		Change
Change`Noun`CmdImpl		Change
Change`NounNounPart`CmdImpl	BOD	Change	Y
Change`NounNounPart`PostActionCmdImpl	BOD	Change	Y
Change`NounPart`Cmd	BOD	Change
Change`NounPart`PostActionCmd	BOD	Change
Process`Noun`ActionCmd	BOD	Process
Process`Noun`CreateActionCmdImpl	BOD	Process	Y
Process`Noun`Cmd		Process
Process`Noun`CmdImpl		Process
Process`Noun`DeleteActionCmdImpl	BOD	Process	Y
Sync`Noun`Cmd		Sync
Sync`Noun`CmdImpl		Sync
Read`Noun`Mediator	BOD	Get	Y
Read`NounNounPart`Mediator	BOD	Get	Y
Change`Noun`Mediator	BOD	Process Change Sync	Y
Change`Noun`BasePartMediator	BOD	Process Change Sync	Y
Change`NounNounPart`Mediator	BOD	Process Change Sync	Y
`Noun`TypeProtectableProxy.java	BOD		Y
`ServiceModule`Facade.java				Y
`ServiceModule`FacadeBeanImpl.java				Y
`ServiceModule`FacadeImpl.java				Y
`ServiceModule`LocalFacade.java				Y
`ServiceModule`ServicesImpl.java				Y
`ServiceModule`ServicesPortType.java				Y
`ServiceModule`ServicesPortType_RI.java				Y
`ServiceModule`ServicesPortTypeHome.java				Y
`ServiceModule`ApplicationException.java				Y
`ServiceModule`Services_mapping.xml				Y
`ServiceModule`Services.wsdl				Y
ejb-jar.xml
webservices.xml
ibm-ejb-jar-bnd.xmi
ibm-ejb-jar-ext.xmi
ibm-webservices-bnd.xmi
ibm-webservices-ext.xmi
Manifest.mf
Wc`ServiceModule`Messages.properties			Y
`ServiceModule`-cmdreg.xml			Y
`ServiceModule`-Server/sampleData
Noun-Access-Control.xml	BOD		Y
CmdReg.xml			Y

List of generated configuration files for the WC project (WC/xml/config/`packageNamePrefix`.`ServiceModule`)
	SOI/BOD	Implement
Service module configuration		Y
SDO.properties		Y
wc-component-client.xml		Y
wc-component.xml		Y
wc-business-object-mediator.xml	BOD	Y
wc-object-relational-metadata.xml	BOD	Y
wc-query-noun-get.tpl	BOD	Y
wc-query-noun-update.tpl	BOD	Y

List of generated files for `ServiceModule`ServicesHTTPInterface.
	SOI/BOD	Verb	Implement	Regenerated
`ServiceModule`ServicesHTTPInterface
.websettings
website-config
Manifest.mf
ibm-web-bnd.xmi
ibm-web-ext.xmi
web.xml

Note: Generally, you should not need to modify the ServiceModuleServicesHTTPInterface project or its generated files.

List of generated files for `ServiceModule`ServicesJMSInterface.
	SOI/BOD	Verb	Implement	Regenerated
`ServiceModule`ServicesJMSInterface
ejb-jar.xml
ibm-ejbext.properties
ibm-ejb-jar-bnd.xmi
Manifest.mf

Note: Generally, you should not need to modify the ServiceModuleServicesJMSInterface project or its generated files.