We now have to
Excerpt |
---|
configure the http-consumer-su |
.
Configuring pom.xml
Changing the project name
In order to make the build output a little bit more comprehensible, we first change the project name in the generated pom.xml file.
Code Block |
---|
|
<project>
...
<name>Http Uploader :: HTTP Consumer SU</name>
...
</project>
|
Adding dependencies
In this case, we already have one set dependency called servicemix-http
. We are going to add some more dependencies now:
- servicemix-core - for access to marshaler classes used later
- commons-fileupload - for parsing multipart-formdata as provided by our upload form later on
- commons-io - for easy file handling
The
No Format |
---|
${servicemix-version} |
is a variable defined at the end of the pom.xml file. We keep using it for servicemix-core.
Modify your dependencies section now to look like the following:
Code Block |
---|
|
<dependencies>
<dependency>
<groupId>org.apache.servicemix</groupId>
<artifactId>servicemix-core</artifactId>
<version>${servicemix-version}</version>
</dependency>
<dependency>
<groupId>org.apache.servicemix</groupId>
<artifactId>servicemix-http</artifactId>
<version>${servicemix-version}</version>
</dependency>
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.2</version>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>1.2</version>
</dependency>
</dependencies>
|
Configuring xbean.xml
Next, we will have to configure our new SU to really provide some services. We do this by modifying the file named xbean.xml
in the src/main/resources
directory of our http-consumer-su module. The sample shown below defines two namespaces: the http
prefix refers to namespace to address the standard http functionality, while the ex
prefix will be used for the namespace in which all our services will be defined.
Code Block |
---|
|
<beans xmlns:http="http://servicemix.apache.org/http/1.0"
xmlns:ex="http://www.servicemix.org/example">
...
</beans>
|
Defining the http consumer endpoint
To accept data under a specific URI we need to define a http consumer endpoint. With the XML snippet shown below, we create such a consumer endpoint by using appropriate XML element and specifying additional configuration like the service name, endpoint name , etc.
Code Block |
---|
|
<http:consumer service="ex:httplistener"
endpoint="listenerEndpoint"
locationURI="http://localhost:8192/upload/"
defaultMep="http://www.w3.org/2004/08/wsdl/in-out"
targetService="ex:httphandler"
marshaler="#marshaler" />
|
The locationURI attribute defines where to accept incoming data. The targetService attribute specifies the service to deliver the data to. The last but very important attribute is the marshaler. This attribute does still not show up in the documentation directly. You can use this marshaler inside the http:consumer element. This element is existing in ServiceMix version 3.2 and above only. Via this marshaler you can define your own handler for incoming and outgoing data. We will discuss this later on more detailed. The value entered here as marshaler is a reference to a bean defined later in the xbean.xml file, therefor it starts with the # char followed by the identifier/name of the bean.
Defining the marshaler bean
Now it's time to define the marshaler bean. The id is what you specified in the marshaler attribute. The class is the full class name of the marshaler class. This class has to implement the interface HttpConsumerMarshaler directly or indirectly. We will discuss this later.
Code Block |
---|
|
<bean id="marshaler" class="org.apache.servicemix.jbi.HTTPMarshaler" />
|
The finished xbean.xml
Code Block |
---|
| xml |
---|
| xml |
---|
title | xbean.xml |
---|
borderStyle | solid |
---|
|
<?xml version="1.0" encoding="UTF-8"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<beans xmlns:http="http://servicemix.apache.org/http/1.0"
xmlns:ex="http://www.servicemix.org/example">
<http:consumer service="ex:httplistener"
endpoint="listenerEndpoint"
locationURI="http://localhost:8192/upload/"
defaultMep="http://www.w3.org/2004/08/wsdl/in-out"
targetService="ex:httphandler"
marshaler="#marshaler" />
<bean id="marshaler" class="org.apache.servicemix.jbi.HTTPMarshaler" />
</beans>
|
Now, all we have to do is to write the marshaler class and the SU is done.
Things to remember
- You specify the target component for a SU as a normal dependency in Maven's pom.xml file
- In ServiceMix, most service units will be configured by a file named
xbean.xml
Further reading
- servicemix-http contains more information about the servicemix-http JBI component and an overview of the various configuration options.