Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

このコンテンツは選択した言語では利用できません。

Chapter 2. Getting Started with Developing

Abstract

This chapter explains how to get started with Maven-based development, with a two-part project that illustrates how to develop applications using Apache CXF and Apache Camel.

2.1. Create a Web Services Project
リンクのコピー

Overview
リンクのコピー

This section describes how to generate a simple Web services project, which includes complete demonstration code for a server and a test client. The starting point for this project is the servicemix-cxf-code-first-osgi-bundle Maven archetype, which is a command-line wizard that creates the entire project from scratch. Instructions are then given to build the project, deploy the server to the Red Hat JBoss Fuse container, and run the test client.

Prerequisites
リンクのコピー

In order to access artifacts from the Maven repository, you need to add the fusesource repository to Maven's settings.xml file. Maven looks for your settings.xml file in the following standard location:
  • UNIX: home/User/.m2/settings.xml
  • Windows: Documents and Settings\User\.m2\settings.xml
If there is currently no settings.xml file at this location, you need to create a new settings.xml file. Modify the settings.xml file by adding the repository element for fusesource, as highlighted in the following example: 
<settings>
    <profiles>
        <profile>
            <id>my-profile</id>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            <repositories>
                <repository>
                    <id>fusesource</id>
                    <url>http://repo.fusesource.com/nexus/content/groups/public/</url>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                </repository>
                ...
            </repositories>
        </profile>
    </profiles>
    ...
</settings>
Copy to Clipboard Toggle word wrap

Create project from the command line
リンクのコピー

You can create a Maven project directly from the command line, by invoking the archetype:generate goal. First of all, create a directory to hold your getting started projects. Open a command prompt, navigate to a convenient location in your file system, and create the get-started directory, as follows: 
mkdir get-started
cd get-started
Copy to Clipboard Toggle word wrap
You can now use the archetype:generate goal to invoke the servicemix-cxf-code-first-osgi-bundle archetype, which generates a simple Apache CXF demonstration, as follows: 
mvn archetype:generate
-DarchetypeGroupId=org.apache.servicemix.tooling
-DarchetypeArtifactId=servicemix-cxf-code-first-osgi-bundle
-DarchetypeVersion=2013.01.0.redhat-610379
-DgroupId=org.fusesource.example
-DartifactId=cxf-basic
-Dversion=1.0-SNAPSHOT
Copy to Clipboard Toggle word wrap
Note
The arguments of the preceding command are shown on separate lines for readability, but when you are actually entering the command, the entire command must be entered on a single line.
You will be prompted to confirm the project settings, with a message similar to this one: 
[INFO] Using property: groupId = org.fusesource.example
[INFO] Using property: artifactId = cxf-basic
[INFO] Using property: version = 1.0-SNAPSHOT
[INFO] Using property: package = org.fusesource.example
Confirm properties configuration:
groupId: org.fusesource.example
artifactId: cxf-basic
version: 1.0-SNAPSHOT
package: org.fusesource.example
Y: :
Copy to Clipboard Toggle word wrap
Press the Return key to accept the settings and generate the project. When the command finishes, you should find a new Maven project in the get-started/cxf-basic directory.

Customize the POM file
リンクのコピー

Because this project will be configured using Blueprint XML, it is necessary to edit the project's pom.xml file, to declare the Blueprint dependency. Edit the cxf-basic/pom.xml file and modify the Import-Package element of the maven-bundle-plugin by adding the lines highlighted in the following extract: 
<?xml version="1.0" encoding="UTF-8"?>
<project ...>
    ...
    <build>
        <defaultGoal>install</defaultGoal>
        <plugins>
            ...
            <plugin>
                <groupId>org.apache.felix</groupId>
                <artifactId>maven-bundle-plugin</artifactId>
                <version>2.3.6</version>
                <extensions>true</extensions>
                <configuration>
                    <instructions>
                        <Bundle-SymbolicName>${project.artifactId}</Bundle-SymbolicName>
                        <Import-Package>
                            javax.jws,
                            javax.wsdl,
                            javax.xml.bind,
                            javax.xml.bind.annotation,
                            javax.xml.namespace,
                            javax.xml.ws,
                            META-INF.cxf,
                            META-INF.cxf.osgi,
                            org.apache.cxf.bus,
                            org.apache.cxf.bus.spring,
                            org.apache.cxf.bus.resource,
                            org.apache.cxf.configuration.spring,
                            org.apache.cxf.resource,
                            org.apache.cxf.jaxws,
                            org.apache.cxf.transport.http,
                            org.osgi.service.blueprint,
                            *
                        </Import-Package>
                        ...
                    </instructions>
                </configuration>
            </plugin>
        </plugins>
    </build>
    ...
</project>
Copy to Clipboard Toggle word wrap

Blueprint XML configuration
リンクのコピー

We are going to use Blueprint XML to configure this project (Spring XML is not ideal in the context of OSGi, because it relies on the deprecated Spring-DM component to access OSGi services). Create the Blueprint XML file, as follows:
  1. Delete the redundant Spring XML file and its parent directories: 
    cd cxf-basic
rm -rf src/main/resources/META-INF
    Copy to Clipboard Toggle word wrap
  2. Create a new directory to hold the Blueprint configuration files: 
    mkdir -p src/main/resources/OSGI-INF/blueprint
    Copy to Clipboard Toggle word wrap
  3. Create a new Blueprint XML file. Using your favourite text editor, create the file, cxf-basic/src/main/resources/OSGI-INF/blueprint/beans.xml, and add the following content to it:

    Example 2.1. Blueprint XML for Web Services Endpoint

    <?xml version="1.0" encoding="UTF-8"?>
<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xmlns:jaxws="http://cxf.apache.org/blueprint/jaxws"
           xmlns:cxf="http://cxf.apache.org/blueprint/core"
           xsi:schemaLocation="
      http://cxf.apache.org/blueprint/core http://cxf.apache.org/schemas/blueprint/core.xsd
      http://cxf.apache.org/blueprint/jaxws http://cxf.apache.org/schemas/blueprint/jaxws.xsd">

    <jaxws:endpoint id="HTTPEndpoint"
        implementor="org.fusesource.example.PersonImpl"
        address="/PersonServiceCF"/>

</blueprint>
    Copy to Clipboard Toggle word wrap
    The purpose of this Blueprint XML file is to create a WS endpoint (that is, an instance of a Web service). The jaxws:endpoint element creates the WS endpoint and, in this example, it requires two attributes, as follows:
    implementor
    Specifies the class that implements the Service Endpoint Interface (SEI).
    address
    Specifies the WS endpoint address. In this example, instead of a HTTP URL, the address is specified as a relative path. In the context of JBoss Fuse, this is taken to mean that the Web service should be installed into the JBoss Fuse container's default Jetty container. By default, the specified path gets prefixed by http://localhost:8181/cxf/, so the actual address of the Web service becomes: 
    http://localhost:8181/cxf/PersonServiceCF
    Copy to Clipboard Toggle word wrap

Build the Web services project
リンクのコピー

Build the Web services project and install the generated JAR file into your local Maven repository. From a command prompt, enter the following commands: 
cd cxf-basic
mvn install
Copy to Clipboard Toggle word wrap

Initialize container security
リンクのコピー

If you have not already done so, create one (or more users) by adding a line of the following form to the InstallDir/etc/users.properties file: 
Username=Password[,RoleA][,RoleB]...
Copy to Clipboard Toggle word wrap
At least one of the users must have the admin role, to enable administration of the fabric. For example: 
admin=secretpassword,admin
Copy to Clipboard Toggle word wrap

Start up the container
リンクのコピー

Start up the JBoss Fuse container. Open a new command prompt and enter the following commands: 
cd InstallDir/bin
fuse
Copy to Clipboard Toggle word wrap
You will see a welcome screen similar to this: 
      _ ____                  ______
     | |  _ \                |  ____|             
     | | |_) | ___  ___ ___  | |__ _   _ ___  ___
 _   | |  _ < / _ \/ __/ __| |  __| | | / __|/ _ \
| |__| | |_) | (_) \__ \__ \ | |  | |_| \__ \  __/
 \____/|____/ \___/|___/___/ |_|   \__,_|___/\___|

  JBoss Fuse (6.1.0.redhat-379)
  http://www.redhat.com/products/jbossenterprisemiddleware/fuse/

Hit '<tab>' for a list of available commands
and '[cmd] --help' for help on a specific command.

Open a browser to http://localhost:8181 to access the management console

Hit '<ctrl-d>' or 'osgi:shutdown' to shutdown JBoss Fuse.

JBossFuse:karaf@root
Copy to Clipboard Toggle word wrap

Install prerequisite features
リンクのコピー

If you are using the Red Hat JBoss Fuse 6.1.0 Medium Install package or the Red Hat JBoss Fuse 6.1.0 Minimal Install package, you need to install additional Karaf features, as follows: 
JBossFuse:karaf@root> features:install cxf
JBossFuse:karaf@root> features:install cxf-http-jetty
JBossFuse:karaf@root> features:install cxf-jaxws
Copy to Clipboard Toggle word wrap
Note
These features are pre-installed in the Red Hat JBoss Fuse 6.1.0 Full Install package.

Deploy and start the WS server
リンクのコピー

To install the cxf-basic Web service as an OSGi bundle, enter the following console command: 
JBossFuse:karaf@root> install mvn:org.fusesource.example/cxf-basic/1.0-SNAPSHOT
Copy to Clipboard Toggle word wrap
Note
If your local Maven repository is stored in a non-standard location, you might need to customize the value of the org.ops4j.pax.url.mvn.localRepository property in the InstallDir/etc/org.ops4j.pax.url.mvn.cfg file, before you can use the mvn: scheme to access Maven artifacts.
If the bundle is successfully resolved and installed, the container responds by giving you the ID of the newly created bundle—for example: 
Bundle ID: 229
Copy to Clipboard Toggle word wrap
You can now start up the Web service using the start console command, specifying the bundle ID, as follows: 
JBossFuse:karaf@root> start 229
Copy to Clipboard Toggle word wrap

Check that the bundle has started
リンクのコピー

To check that the bundle has started, enter the list console command, which gives the status of all the bundles installed in the container: 
JBossFuse:karaf@root> list
Copy to Clipboard Toggle word wrap
Near the end of the listing, you should see a status line like the following: 
[ 229] [Active     ] [            ] [Started] [   60]
Apache ServiceMix :: CXF Code First OSGi Bundle (1.0.0.SNAPSHOT)
Copy to Clipboard Toggle word wrap
Note
Actually, to avoid clutter, the list command only shows the bundles with a start level of 50 or greater (which excludes most of the system bundles).

Run the WS client
リンクのコピー

The cxf-basic project also includes a simple WS client, which you can use to test the deployed Web service. In a command prompt, navigate to the cxf-basic directory and run the simple WS client as follows: 
cd get-started/cxf-basic
mvn -Pclient
Copy to Clipboard Toggle word wrap
If the client runs successfully, you should see output like the following: 
INFO: Creating Service {http://example.fusesource.org/}PersonService from class org.fusesource.example.Person
Invoking getPerson...
getPerson._getPerson_personId=Guillaume
getPerson._getPerson_ssn=000-000-0000
getPerson._getPerson_name=Guillaume
Copy to Clipboard Toggle word wrap

Troubleshooting
リンクのコピー

If you have trouble running the client, there is an even simpler way to connect to the Web serivice. Open your favorite Web browser and navigate to the following URL to contact the JBoss Fuse Jetty container: 
http://localhost:8181/cxf?wsdl
Copy to Clipboard Toggle word wrap
To query the WSDL directly from the PersonService Web service, navigate to the following URL: 
http://localhost:8181/cxf/PersonServiceCF?wsdl
Copy to Clipboard Toggle word wrap
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat