Page History

1. <GERONIMO_HOME>\var\config\config.xml

1. • Add

1. • the

1. • gbean

1. • xml-fragment

1. • given

1. • in

1. • Listing-1

1. • under

1. • "org.apache.geronimo.configs/tomcat6-deployer/2.1.4/car"

1. • module.

1. • Add

1. • the

1. • gbean

1. • xml-fragment

1. • given

1. • in

1. • Listing-2

1. • under

1. • "org.apache.geronimo.configs/openejb-deployer/2.1.4/car"

1. • module.

1. • If

1. • you

1. • are

1. • starting

1. • with

1. • a

1. • fresh

1. • Geronimo

1. • Tomcat

1. • 2.1.4

1. • server,

1. • you

1. • can

1. • replace

1. • <GERONIMO_HOME>\var\config\config.xml

1. • with

1. • config.xml

1. • available

1. • at

1. • this

1. • link

1. • .

2. Start Geronimo.
3. Download tuscany-tomcat-1.0-SNAPSHOT.car

1. from

1. http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/tuscany-tomcat/1.0-SNAPSHOT/

2. Deploy

1. the

1. plugin

1. using

1. the

1. command

1. "<GERONIMO_HOME>\bin\deploy

1. install-plugin

1. tuscany-tomcat-1.0-SNAPSHOT.car".

1. The

1. default

1. username/password

1. to

1. perform

1. the

1. deployment

1. is

1. system/manager.

1. 
   Listing-1:

1. Code Block

1. <gbean name="TomcatWebBuilder"> <reference name="ModuleBuilderExtensions"> <pattern> <name>TuscanyModuleBuilderExtension</name> </pattern> <pattern> <name>PersistenceUnitBuilder</name> </pattern> <pattern> <name>JspModuleBuilderExtension</name> </pattern> <pattern> <name>MyFacesModuleBuilderExtension</name> </pattern> </reference> </gbean>

1. Listing-2:

1. Code Block

1. <gbean name="EJBBuilder"> <reference name="ModuleBuilderExtensions"> <pattern> <name>Axis2ModuleBuilderExtension</name> </pattern> <pattern> <name>AxisModuleBuilderExtension</name> </pattern> <pattern> <name>CorbaModuleBuilderExtension</name> </pattern> <pattern> <name>TuscanyModuleBuilderExtension</name> </pattern> <pattern> <name>PersistenceUnitBuilder</name> </pattern> <pattern> <name>CXFModuleBuilderExtension</name> </pattern> </reference> </gbean>

2. Download xbean-finder-3.6.jar

1. from

1. http://repo1.maven.org/maven2/org/apache/xbean/xbean-finder/3.6/xbean-finder-3.6.jar

1. and

1. save

1. to

1. <GERONIMO_HOME>\repository\org\apache\xbean\xbean-finder\3.6

1. \ (not needed for Geronimo 2.1.5)
2. Add the text in Listing-2B

1. to

1. <GERONIMO_HOME>\var\config\artifact-aliases.properties

1. 
   Listing-2B:

1. Code Block

1. org.apache.xbean/xbean-finder/3.5/jar=org.apache.xbean/xbean-finder/3.6/jar org.apache.xbean/xbean-finder//jar=org.apache.xbean/xbean-finder/3.6/jar

2. Download openejb-core-3.0.1.jar

1. from

1. this

1. link

1. and

1. replace

1. <GERONIMO_HOME>\repository\org\apache\openejb\openejb-core\3.0.1\openejb-core-3.0.1.jar.

1. Note:

1. This

1. jar

1. is

1. patched

1. to

1. account

1. for

1. OPENEJB-1005

1. . (not needed for Geronimo 2.1.5)

Installing on Geronimo Jetty server

Follow the steps below to install the plugin on Geronimo v2.1.4

with

Jetty

as

the

web

container.

1. Edit

1. <GERONIMO_HOME>\var\config\config.xml

1. • Add

1. • the

1. • gbean

1. • xml-fragment

1. • given

1. • in

1. • Listing-3

1. • under

1. • "org.apache.geronimo.configs/jetty6-deployer/2.1.4/car"

1. • module.

1. • Add

1. • the

1. • gbean

1. • xml-fragment

1. • given

1. • in

1. • Listing-2

1. • under

1. • "org.apache.geronimo.configs/openejb-deployer/2.1.4/car"

1. • module.

1. • Note

1. • If

1. • you

1. • are

1. • starting

1. • with

1. • a

1. • fresh

1. • Geronimo

1. • Jetty

1. • 2.1.4

1. • server,

1. • you

1. • can

1. • replace

1. • <GERONIMO_HOME>\var\config\config.xml

1. • with

1. • config.xml

1. • available

1. • at

1. • this

1. • link

1. • .

1. • NEED

1. • TO

1. • UPDATE

1. • THE

1. • FILE

1. • AND

1. • LINK

2. Start Geronimo.
3. Download tuscany-jetty-1.0-SNAPSHOT.car

1. from

1. http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/tuscany-jetty/1.0-SNAPSHOT/

2. Deploy

1. the

1. plugin

1. using

1. the

1. command

1. "<GERONIMO_HOME>\bin\deploy

1. install-plugin

1. tuscany-jetty-1.0-SNAPSHOT.car".

1. The

1. default

1. username/password

1. to

1. perform

1. the

1. deployment

1. is

1. system/manager.

1. 
   Listing-3:

1. Code Block

1. <gbean name="JettyWebBuilder"> <reference name="ModuleBuilderExtensions"> <pattern> <name>TuscanyModuleBuilderExtension</name> </pattern> <pattern> <name>PersistenceUnitBuilder</name> </pattern> <pattern> <name>JspModuleBuilderExtension</name> </pattern> <pattern> <name>MyFacesModuleBuilderExtension</name> </pattern> </reference> </gbean>

2. Download xbean-finder-3.6.jar

1. from

1. http://repo1.maven.org/maven2/org/apache/xbean/xbean-finder/3.6/xbean-finder-3.6.jar

1. and

1. save

1. to

1. <GERONIMO_HOME>\repository\org\apache\xbean\xbean-finder\3.6\

2. Add

1. the

1. text

1. in

1. Listing-2B

1. to

1. <GERONIMO_HOME>\var\config\artifact-aliases.properties

2. Download

1. openejb-core-3.0.1.jar

1. from

1. this

1. link

1. and

1. replace

1. <GERONIMO_HOME>\repository\org\apache\openejb\openejb-core\3.0.1\openejb-core-3.0.1.jar.

1. Note:

1. This jar is patched to account for OPENEJB-1005

1. .

Building

the

plugin

from

source

and

installing

the

plugin

If

you

want

to

build

the

plugin

from

source

and

then

install

the

plugin

in

Geronimo

server,

follow

the

steps

below.

1. Checkout

1. the

1. plugin

1. source

1. from

1. http://svn.apache.org/repos/asf/geronimo/plugins/tuscany/trunk/

2. Open

1. a

1. command

1. window

1. and

1. change

1. to

1. the

1. directory

1. to

1. which

1. source

1. is

1. checked

1. out.

2. Build

1. the

1. plugin

1. using

1. the

1. command

1. "mvn

1. install"

2. Edit

1. <GERONIMO_HOME>\var\config\config.xml

1. • In

1. • Geronimo

1. • Tomcat

1. • v2.1.4

1. • server

1. • • Add

1. • • the

1. • • gbean

1. • • xml-fragment

1. • • given

1. • • in

1. • • Listing-1

1. • • under

1. • • "org.apache.geronimo.configs/tomcat6-deployer/2.1.4/car"

1. • • module.

1. • • Add

1. • • the

1. • • gbean

1. • • xml-fragment

1. • • given

1. • • in

1. • • Listing-2

1. • • under

1. • • "org.apache.geronimo.configs/openejb-deployer/2.1.4/car"

1. • • module.

1. • In

1. • Geronimo

1. • Jetty

1. • v2.1.4

1. • server

1. • • Add

1. • • the

1. • • gbean

1. • • xml-fragment

1. • • given

1. • • in

1. • • Listing-3

1. • • under

1. • • "org.apache.geronimo.configs/jetty6-deployer/2.1.4/car"

1. • • module.

1. • • Add

1. • • the

1. • • gbean

1. • • xml-fragment

1. • • given

1. • • in

1. • • Listing-2

1. • • under

1. • • "org.apache.geronimo.configs/openejb-deployer/2.1.4/car"

1. • • module.

2. Start

1. the

1. Geronimo

1. server.

2. Access

1. http://localhost:8080/console

1. and

1. navigate

1. to

1. "Plugins"

1. portlet.

2. Click

1. "Add

1. Repository"

1. link

1. under

1. Install

1. Geronimo

1. Plugins

1. section.

2. Enter

1. the

1. URL

1. of

1. your

1. local

1. maven2

1. repository

1. and

1. click

1. "Add

1. Repository"

1. button.

1. • For

1. • example,

1. • if

1. • your

1. • local

1. • maven2

1. • repository

1. • directory

1. • is

1. • D:\m2repo

1. • use

1. • the

1. • URL

1. • file:/D:/m2repo

2. In

1. the

1. "Repository"

1. dropdown

1. list,

1. select

1. your

1. local

1. maven2

1. repository

1. added

1. in

1. the

1. previous

1. step

1. and

1. click

1. "Show

1. Plugins

1. in

1. selected

1. repository"

1. button.

2. Select

1. "Geronimo

1. ::

1. Tuscany

1. Plugin

1. for

1. Geronimo

1. Tomcat"

1. ("Geronimo

1. ::

1. Tuscany

1. Plugin

1. for

1. Geronimo

1. Jetty"

1. in

1. case

1. of

1. Geronimo

1. Jetty

1. server)

1. and

1. click

1. Install

1. .

2. In

1. the

1. plugin

1. information

1. page,

1. click

1. Install

1. to

1. complete

1. the

1. plugin

1. installation.

Anchor
Sample Applications Sample Applications

Background Color
color #C3CDA1
Sample Applications

Anchor
Deploy helloworld Application Deploy helloworld Application

Background Color
color #C3CDA1
Deploy helloworld Application

We have a sample sca contribution (helloworld-service)

that

has

three

Helloworld

service

components.

The

JSP,

Servlet

and

EJB

samples

access

the

services

provided

by

this

contribution.

Follow

the

steps

below

to

deploy

the

helloworld-service.

1. Download

1. helloworld-service-1.0-SNAPSHOT.jar

1. from

1. http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-service/1.0-SNAPSHOT/

2. Access http://localhost:8080/console

1. and

1. navigate

1. to

1. "Deploy

1. New"

1. portlet.

2. In

1. the

1. Archive

1. field,

1. select

1. helloworld-service-1.0-SNAPSHOT.jar

1. downloaded

1. above.

2. Click

1. Install

1. to

1. install

1. the

1. sca

1. contribution.

Anchor
Access helloworld From JSP Access helloworld From JSP

Background Color
color #C3CDA1
Access helloworld From JSP

The sample web application helloworld-jsp has a JSP that defines an SCA reference using SCA JSP tag library. The reference is wired in web.composite. The reference is injected at runtime.

Follow the steps below to run the sample application.

1. Download helloworld-jsp-1.0-SNAPSHOT.war

1. from

1. http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-jsp/1.0-SNAPSHOT/

1. and

1. save

1. as

1. helloworld-jsp.war.

2. Access

1. http://localhost:8080/console

1. and

1. navigate

1. to

1. "Deploy

1. New"

1. portlet.

2. In

1. the

1. Archive

1. field,

1. select

1. helloworld-jsp.war

1. downloaded

1. above.

2. Click

1. Install

1. to

1. install

1. the

1. web

1. application.

2. Access

1. http://localhost:8080/helloworld-jsp/

Anchor
Access helloworld From Servlet Access helloworld From Servlet

Background Color
color #C3CDA1
Access helloworld From Servlet

The sample web application helloworld-servlet has a HelloworldServlet with @Reference, @Property, @Context and @ComponentName annotations. The references are wired in web.composite. The annotated fields are injected at runtime.

Follow the steps below to run the sample application.

1. Download helloworld-servlet-1.0-SNAPSHOT.war

1. from

1. http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-servlet/1.0-SNAPSHOT/

1. and

1. save

1. as

1. helloworld-servlet.war

2. Access

1. http://localhost:8080/console

1. and

1. navigate

1. to

1. "Deploy

1. New"

1. portlet.

2. In

1. the

1. Archive

1. field,

1. select

1. helloworld-servlet.war

1. downloaded

1. above.

2. Click

1. Install

1. to

1. install

1. the

1. web

1. application.

2. Access

1. http://localhost:8080/helloworld-servlet/

Anchor
Access helloworld From a session EJB Access helloworld From a session EJB

Background Color
color #C3CDA1
anchor:Access helloworld From a session EJB

The sample EJB application helloworld-ejb has a Stateless session bean HelloworldServiceBean with @Reference, @Property, @Context and @ComponentName annotations. The references are wired in ejb-jar.composite.

The

annotated

fields

are

injected

at

runtime.

The

sample

web

application

helloworld-web

has

a

HelloworldEjbServlet

that

invokes

HelloworldServiceBean.

Follow

the

steps

below

to

run

the

sample

application.

1. Download

1. helloworld-ejb-1.0-SNAPSHOT.jar

1. from

1. http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-ejb/1.0-SNAPSHOT/

2. Download

1. helloworld-web-1.0-SNAPSHOT.war

1. from

1. http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-web/1.0-SNAPSHOT/

1. and

1. save

1. as

1. helloworld-web.war.

2. Access

1. http://localhost:8080/console

1. and

1. navigate

1. to

1. "Deploy

1. New"

1. portlet.

2. In

1. the

1. Archive

1. field,

1. select

1. helloworld-ejb-1.0-SNAPSHOT.jar

1. downloaded

1. above.

2. Click

1. Install

1. to

1. install

1. the

1. ejb

1. application.

2. In

1. the

1. Archive

1. field,

1. select

1. helloworld-web.war

1. downloaded

1. above.

2. Click

1. Install

1. to

1. install

1. the

1. web

1. application.

2. Access

1. http://localhost:8080/helloworld-web/

Access an SCA service from an MDB

The sample EJB application helloworld-mdb-ejb

has

a

message-driven-bean

HelloworldMDB

that

listens

on

a

JMS

queue

named

NamesQueue.

HelloworldMDB

has

@Reference,

@Property,

@Context

and

@ComponentName

annotations.

The

references

are

wired

in

ejb-jar.composite.

The

annotated

fields

are

injected

at

runtime.

The

sample

web

application

helloworld-mdb-web

has

a

HelloworldMdbServlet

that

sends

the

name

entered

in

the

webpage

as

a

message

to

the

NamesQueue.

Output

from

HelloworldMDB

can

be

seen

in

Geronimo

console

window.

Follow

the

steps

below

to

run

the

sample

application.

1. Download

1. jms-resources.xml

2. Download helloworld-mdb-ejb-1.0-SNAPSHOT.jar

1. from

1. http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-mdb-ejb/1.0-SNAPSHOT/

2. Download

1. helloworld-mdb-web-1.0-SNAPSHOT.war

1. from

1. http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-mdb-web/1.0-SNAPSHOT/

2. Access http://localhost:8080/console

1. and

1. navigate

1. to

1. "Deploy

1. New"

1. portlet.

2. In

1. the

1. Archive

1. field,

1. select

1. <GERONIMO_HOME>\repository\org\apache\geronimo\modules\geronimo-activemq-ra\2.1.4\geronimo-activemq-ra-2.1.4.rar

2. In

1. the

1. Plan

1. field,

1. select

1. jms-resources.xml

1. downloaded

1. above.

2. Click

1. Install

1. to

1. complete

1. creating

1. JMS

1. resources.

2. In

1. the

1. Archive

1. field,

1. select

1. helloworld-mdb-ejb-1.0-SNAPSHOT.jar

1. downloaded

1. above.

2. Click

1. Install

1. to

1. install

1. the

1. ejb

1. application.

2. In

1. the

1. Archive

1. field,

1. select

1. helloworld-mdb-web-1.0-SNAPSHOT.war

1. downloaded

1. above.

2. Click

1. Install

1. to

1. install

1. the

1. web

1. application.

2. Access

1. http://localhost:8080/helloworld-mdb-web/

Access an SCA service from a Filter

*Note:

explain

why

this

is

useful

from

user's

prespective.

Would

users

do

this?

The

sample

web

application

helloworld-filter

has

a

filter

HelloworldFilter

with

@Reference,

@Property,

@Context

and

@ComponentName

annotations.

The

references

are

wired

in

web.composite.

The

annotated

fields

are

injected

at

runtime.

Follow

the

steps

below

to

run

the

sample

application.

1. Download

1. helloworld-filter-1.0-SNAPSHOT.war

1. from

1. http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-filter/1.0-SNAPSHOT/

2. Access http://localhost:8080/console

1. and

1. navigate

1. to

1. "Deploy

1. New"

1. portlet.

2. In

1. the

1. Archive

1. field,

1. select

1. helloworld-filter-1.0-SNAPSHOT.war

1. downloaded

1. above.

2. Click

1. Install

1. to

1. install

1. the

1. web

1. application.

2. Access

1. http://localhost:8080/helloworld-filter/

Access an SCA service from an Event Listener

*Note:

explain

why

users

would

od

this?*

The

sample

web

application

helloworld-listener

has

a

ServletContextListener,

a

ServletContextAttributeListener,

a

ServletRequestListener,

a

ServletRequestAttributeListener,

an

HttpSessionListener,

and

an

HttpSessionAttributeListener

with

@Reference,

@Property,

@Context

and

@ComponentName

annotations.

The

references

are

wired

in

web.composite.

The

annotated

fields

are

injected

at

runtime.

Follow

the

steps

below

to

run

the

sample

application.

1. Download

1. helloworld-listener-1.0-SNAPSHOT.war

1. from

1. http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-listener/1.0-SNAPSHOT/

2. Access http://localhost:8080/console

1. and

1. navigate

1. to

1. "Deploy

1. New"

1. portlet.

2. In

1. the

1. Archive

1. field,

1. select

1. helloworld-listener-1.0-SNAPSHOT.war

1. downloaded

1. above.

2. Click

1. Install

1. to

1. install

1. the

1. web

1. application.

2. Access

1. http://localhost:8080/helloworld-listener/

Access an SCA service from a JSF managed bean

The sample JSF application helloworld-jsf has a controller class HelloWorldController with @Reference, @Property, @Context and @ComponentName annotations. The references are wired in web.composite. The annotated fields are injected at runtime.

Follow the steps below to run the sample application.

1. Download helloworld-jsf-1.0-SNAPSHOT.war

1. from

1. http://people.apache.org/repo/m2-snapshot-repository/org/apache/geronimo/plugins/helloworld-jsf/1.0-SNAPSHOT/

2. Access http://localhost:8080/console

1. and

1. navigate

1. to

1. "Deploy

1. New"

1. portlet.

2. In

1. the

1. Archive

1. field,

1. select

1. helloworld-jsf-1.0-SNAPSHOT.war

1. downloaded

1. above.

2. Click

1. Install

1. to

1. install

1. the

1. web

1. application.

2. Access

1. http://localhost:8080/helloworld-jsf/

A sample that demonstrates a mix of the above features – IN PROGRESS

This sample demonstrates the following features:

1. An SCA reference in a JSP is wired to an (external) webservice using binding.ws
2. An SCA reference in a servlet is injected with proxy to a service provided by a regular SCA component which is within the web application.
3. References in the regular SCA component are wired to other components in the SCA domain and to external webservice using binding.ws
4. SCA references injected into a session bean.