diff --git a/.gitignore b/.gitignore index d31abc96..22715ed2 100644 --- a/.gitignore +++ b/.gitignore @@ -8,7 +8,6 @@ build # eclipse .classpath .settings -.springBeans .project # idea diff --git a/pom.xml b/pom.xml deleted file mode 100644 index c9fbf536..00000000 --- a/pom.xml +++ /dev/null @@ -1,273 +0,0 @@ - - - 4.0.0 - org.springframework.amqp - spring-amqp-dist - Spring AMQP Distribution - 1.0.0.BUILD-SNAPSHOT - pom - - spring-amqp-parent - spring-amqp-core - spring-rabbit - spring-erlang - spring-rabbit-admin - - - UTF-8 - - spring-amqp - Spring AMQP - AMQP - ${project.version} - snapshot - ${dist.id}-${dist.version} - ${dist.finalName}.zip - target/${dist.fileName} - dist.springframework.org - - - - - staging - - - spring-site-staging - file:///${java.io.tmpdir}/spring-amqp/docs/${project.version} - - - spring-milestone-staging - file:///${java.io.tmpdir}/spring-amqp/milestone - - - spring-snapshot-staging - file:///${java.io.tmpdir}/spring-amqp/snapshot - - - - - - http://git.springframework.org/spring-amqp - scm:git:git://git.springsource.org/spring-amqp/spring-amqp.git - scm:git:git://git.springsource.org/spring-amqp/spring-amqp.git - - - - http://www.springsource.com/download/community - - spring-site - scp://static.springframework.org/var/www/domains/springframework.org/static/htdocs/spring-amqp/docs/${project.version} - - - spring-milestone - Spring Milestone Repository - s3://maven.springframework.org/milestone - - - spring-snapshot - Spring Snapshot Repository - s3://maven.springframework.org/snapshot - - - - - - - org.springframework.build.aws - org.springframework.build.aws.maven - 3.0.0.RELEASE - - - - - com.agilejava.docbkx - docbkx-maven-plugin - 2.0.6 - - - - generate-html - generate-pdf - - package - - - - - org.docbook - docbook-xml - 4.4 - runtime - - - - index.xml - true - ${project.basedir}/src/docbkx/resources/xsl/fopdf.xsl - - css/html.css - - false - ${project.basedir}/src/docbkx/resources/xsl/html.xsl - - - - version - ${pom.version} - - - - - - - - - - - - - - - - - - - - - - - maven-javadoc-plugin - 2.5 - - - aggregate - - aggregate - - package - - true - true -
Spring AMQP
- 1.5 - true - ${project.basedir}/src/main/javadoc - ${project.basedir}/src/main/javadoc/overview.html - ${project.basedir}/src/main/javadoc/spring-javadoc.css - - true - - - Spring AMQP - org.springframework.amqp:org.springframework.amqp.* - - - Spring Rabbit - org.springframework.amqp.rabbit.* - - - Spring Rabbit Admin - org.springframework.amqp.rabbit.admin:org.springframework.amqp.rabbit.test - - - Spring Erlang - org.springframework.erlang:org.springframework.erlang.*:org.springframework.util.exec - - - org.springframework.amqp.samples - - http://static.springframework.org/spring/docs/3.0.3.RELEASE/javadoc-api - http://java.sun.com/javase/6/docs/api - -
-
-
-
- - maven-assembly-plugin - 2.2-beta-5 - false - - - distribution - - single - - package - - - ${project.basedir}/src/assembly/distribution.xml - - false - - - - - - org.apache.maven.plugins - maven-antrun-plugin - 1.4 - - - upload-dist - deploy - - - - - - - - - run - - - - - - org.springframework.build - org.springframework.build.aws.ant - 3.0.5.RELEASE - - - net.java.dev.jets3t - jets3t - 0.7.2 - - - -
- - ${dist.finalName} -
- - - repository.springframework.maven.release - Spring Framework Maven Release Repository - http://maven.springframework.org/release - - - repository.springframework.maven.milestone - Spring Framework Maven Milestone Repository - http://maven.springframework.org/milestone - - - - repository.source.maven.release - SpringSource Maven Release Repository - http://repository.springsource.com/maven/bundles/release - - -
diff --git a/spring-amqp-core/.settings/org.maven.ide.eclipse.prefs b/spring-amqp-core/.settings/org.maven.ide.eclipse.prefs deleted file mode 100644 index 3e1fd3f7..00000000 --- a/spring-amqp-core/.settings/org.maven.ide.eclipse.prefs +++ /dev/null @@ -1,9 +0,0 @@ -#Wed Jan 13 19:28:20 EST 2010 -activeProfiles= -eclipse.preferences.version=1 -fullBuildGoals=process-test-resources -includeModules=false -resolveWorkspaceProjects=true -resourceFilterGoals=process-resources resources\:testResources -skipCompilerPlugin=true -version=1 diff --git a/spring-amqp-core/pom.xml b/spring-amqp-core/pom.xml deleted file mode 100644 index ba713c0d..00000000 --- a/spring-amqp-core/pom.xml +++ /dev/null @@ -1,100 +0,0 @@ - - 4.0.0 - - org.springframework.amqp - spring-amqp-parent - 1.0.0.BUILD-SNAPSHOT - ../spring-amqp-parent/pom.xml - - spring-amqp - jar - Spring AMQP Core - - - - org.springframework - spring-oxm - - - org.springframework - spring-test - - - - - javax.annotation - jsr250-api - true - - - cglib - cglib-nodep - true - - - org.mockito - mockito-all - test - - - junit - junit - - - org.codehaus.jackson - jackson-core-asl - - - org.codehaus.jackson - jackson-mapper-asl - - - - - org.slf4j - slf4j-api - - - org.slf4j - jcl-over-slf4j - compile - - - org.slf4j - slf4j-log4j12 - runtime - - - log4j - log4j - - - javax.mail - mail - - - javax.jms - jms - - - com.sun.jdmk - jmxtools - - - com.sun.jmx - jmxri - - - runtime - - - - - - com.springsource.bundlor - com.springsource.bundlor.maven - - - - diff --git a/spring-amqp-parent/.settings/org.maven.ide.eclipse.prefs b/spring-amqp-parent/.settings/org.maven.ide.eclipse.prefs deleted file mode 100644 index 7ccc9920..00000000 --- a/spring-amqp-parent/.settings/org.maven.ide.eclipse.prefs +++ /dev/null @@ -1,9 +0,0 @@ -#Tue Jun 29 21:59:00 EDT 2010 -activeProfiles= -eclipse.preferences.version=1 -fullBuildGoals=process-test-resources -includeModules=false -resolveWorkspaceProjects=true -resourceFilterGoals=process-resources resources\:testResources -skipCompilerPlugin=true -version=1 diff --git a/spring-amqp-parent/pom.xml b/spring-amqp-parent/pom.xml deleted file mode 100644 index a649adf5..00000000 --- a/spring-amqp-parent/pom.xml +++ /dev/null @@ -1,418 +0,0 @@ - - - 4.0.0 - org.springframework.amqp - spring-amqp-parent - Spring AMQP Parent - http://www.springsource.org/spring-amqp - 1.0.0.BUILD-SNAPSHOT - pom - - UTF-8 - - 2.2 - 1.4 - 4.8.2 - 1.2.15 - 1.8.4 - 1.5.10 - 1.4.3 - 1.5.3 - 2.1.0 - 3.0.5.RELEASE - - - - strict - - false - - - - fast - - true - true - - - - staging - - - spring-site-staging - file:///${java.io.tmpdir}/spring-amqp/docs - - - spring-milestone-staging - file:///${java.io.tmpdir}/spring-amqp/milestone - - - spring-snapshot-staging - file:///${java.io.tmpdir}/spring-amqp/snapshot - - - - - bootstrap - - - - - - http://www.springsource.com/download/community - - - spring-docs - scp://static.springframework.org/var/www/domains/springframework.org/static/htdocs/spring-amqp/docs/${project.version} - - - - spring-milestone - Spring Milestone Repository - s3://maven.springframework.org/milestone - - - spring-snapshot - Spring Snapshot Repository - s3://maven.springframework.org/snapshot - - - - - - - - com.rabbitmq - amqp-client - ${com.rabbitmq.version} - - - org.springframework.amqp - spring-amqp - ${project.version} - - - org.springframework.amqp - spring-rabbit - ${project.version} - - - org.springframework.amqp - spring-erlang - ${project.version} - - - - - org.springframework - spring-aop - ${org.springframework.version} - - - org.springframework - spring-beans - ${org.springframework.version} - - - org.springframework - spring-core - ${org.springframework.version} - - - commons-logging - commons-logging - - - - - org.springframework - spring-oxm - ${org.springframework.version} - - - org.springframework - spring-tx - ${org.springframework.version} - - - org.springframework - spring-test - ${org.springframework.version} - test - - - - - - commons-io - commons-io - ${commons-io.version} - - - - - org.slf4j - slf4j-api - ${org.slf4j.version} - - - org.slf4j - jcl-over-slf4j - ${org.slf4j.version} - runtime - - - org.slf4j - slf4j-log4j12 - ${org.slf4j.version} - runtime - - - log4j - log4j - ${log4j.version} - - - javax.mail - mail - - - javax.jms - jms - - - com.sun.jdmk - jmxtools - - - com.sun.jmx - jmxri - - - runtime - - - - javax.annotation - jsr250-api - 1.0 - true - - - - cglib - cglib-nodep - ${cglib.version} - true - - - - org.mockito - mockito-all - ${org.mockito.version} - test - - - - junit - junit - ${junit.version} - test - - - - - org.codehaus.jackson - jackson-core-asl - ${org.codehaus.jackson.version} - - - org.codehaus.jackson - jackson-mapper-asl - ${org.codehaus.jackson.version} - - - - org.erlang.otp - jinterface - ${org.erlang.otp.version} - - - - - - - - log4j - log4j - ${log4j.version} - test - - - - - - - org.springframework.build.aws - org.springframework.build.aws.maven - 3.0.0.RELEASE - - - - - ${project.basedir}/src/main/java - - **/* - - - **/*.java - - - - ${project.basedir}/src/main/resources - - **/* - - - - - - ${project.basedir}/src/test/java - - **/* - - - **/*.java - - - - ${project.basedir}/src/test/resources - - **/* - - - **/*.java - - - - - - org.apache.maven.plugins - maven-compiler-plugin - - 1.5 - 1.5 - -Xlint:all - true - false - - - - org.apache.maven.plugins - maven-surefire-plugin - - false - - **/*Tests.java - - - **/Abstract*.java - **/*IntegrationTests.java - - junit:junit - - - - maven-source-plugin - - - attach-sources - - jar - - - - - - maven-jar-plugin - - - target/classes/META-INF/MANIFEST.MF - - - - - - - - - com.springsource.bundlor - com.springsource.bundlor.maven - - - bundlor - - bundlor - - - - - - - - - - - repository.plugin.springsource.release - SpringSource Maven Repository - http://repository.springsource.com/maven/bundles/release - - - - - repository.springframework.maven.release - Spring Framework Maven Release Repository - http://maven.springframework.org/release - - - repository.springframework.maven.milestone - Spring Framework Maven Milestone Repository - http://maven.springframework.org/milestone - - - repository.springframework.maven.snapshot - Spring Framework Maven Snapshot Repository - http://maven.springframework.org/snapshot - - - - - - - org.apache.maven.plugins - maven-project-info-reports-plugin - 2.1 - - false - - - - - diff --git a/spring-erlang/.settings/org.eclipse.jdt.core.prefs b/spring-erlang/.settings/org.eclipse.jdt.core.prefs deleted file mode 100644 index a8f84131..00000000 --- a/spring-erlang/.settings/org.eclipse.jdt.core.prefs +++ /dev/null @@ -1,6 +0,0 @@ -#Tue Jun 29 21:59:29 EDT 2010 -eclipse.preferences.version=1 -org.eclipse.jdt.core.compiler.codegen.targetPlatform=1.5 -org.eclipse.jdt.core.compiler.compliance=1.5 -org.eclipse.jdt.core.compiler.problem.forbiddenReference=warning -org.eclipse.jdt.core.compiler.source=1.5 diff --git a/spring-erlang/.settings/org.maven.ide.eclipse.prefs b/spring-erlang/.settings/org.maven.ide.eclipse.prefs deleted file mode 100644 index 7ccc9920..00000000 --- a/spring-erlang/.settings/org.maven.ide.eclipse.prefs +++ /dev/null @@ -1,9 +0,0 @@ -#Tue Jun 29 21:59:00 EDT 2010 -activeProfiles= -eclipse.preferences.version=1 -fullBuildGoals=process-test-resources -includeModules=false -resolveWorkspaceProjects=true -resourceFilterGoals=process-resources resources\:testResources -skipCompilerPlugin=true -version=1 diff --git a/spring-erlang/pom.xml b/spring-erlang/pom.xml deleted file mode 100644 index 38553ee5..00000000 --- a/spring-erlang/pom.xml +++ /dev/null @@ -1,103 +0,0 @@ - - 4.0.0 - - org.springframework.amqp - spring-amqp-parent - 1.0.0.BUILD-SNAPSHOT - ../spring-amqp-parent/pom.xml - - spring-erlang - jar - Spring Erlang Support - - - - - org.springframework - spring-beans - - - - - commons-io - commons-io - - - - - org.slf4j - slf4j-api - - - org.slf4j - jcl-over-slf4j - compile - - - org.slf4j - slf4j-log4j12 - runtime - - - log4j - log4j - - - javax.mail - mail - - - javax.jms - jms - - - com.sun.jdmk - jmxtools - - - com.sun.jmx - jmxri - - - runtime - - - - javax.annotation - jsr250-api - true - - - - cglib - cglib-nodep - true - - - - org.mockito - mockito-all - test - - - - junit - junit - - - - org.erlang.otp - jinterface - - - - - - - com.springsource.bundlor - com.springsource.bundlor.maven - - - - diff --git a/spring-rabbit-admin/.settings/org.maven.ide.eclipse.prefs b/spring-rabbit-admin/.settings/org.maven.ide.eclipse.prefs deleted file mode 100644 index 3b616447..00000000 --- a/spring-rabbit-admin/.settings/org.maven.ide.eclipse.prefs +++ /dev/null @@ -1,9 +0,0 @@ -#Tue Jun 29 21:59:01 EDT 2010 -activeProfiles= -eclipse.preferences.version=1 -fullBuildGoals=process-test-resources -includeModules=false -resolveWorkspaceProjects=true -resourceFilterGoals=process-resources resources\:testResources -skipCompilerPlugin=true -version=1 diff --git a/spring-rabbit-admin/pom.xml b/spring-rabbit-admin/pom.xml deleted file mode 100644 index 2d02cb1f..00000000 --- a/spring-rabbit-admin/pom.xml +++ /dev/null @@ -1,128 +0,0 @@ - - 4.0.0 - - org.springframework.amqp - spring-amqp-parent - 1.0.0.BUILD-SNAPSHOT - ../spring-amqp-parent/pom.xml - - spring-rabbit-admin - jar - Spring RabbitMQ Administrative Support - - - com.rabbitmq - amqp-client - - - org.springframework.amqp - spring-amqp - - - org.springframework.amqp - spring-rabbit - - - org.springframework.amqp - spring-erlang - - - - - org.springframework - spring-aop - - - org.springframework - spring-oxm - - - org.springframework - spring-tx - - - org.springframework - spring-test - compile - - - - - commons-io - commons-io - - - - - org.slf4j - slf4j-api - - - org.slf4j - jcl-over-slf4j - compile - - - org.slf4j - slf4j-log4j12 - runtime - - - log4j - log4j - - - javax.mail - mail - - - javax.jms - jms - - - com.sun.jdmk - jmxtools - - - com.sun.jmx - jmxri - - - runtime - - - - javax.annotation - jsr250-api - true - - - - cglib - cglib-nodep - true - - - - org.mockito - mockito-all - test - - - - junit - junit - compile - - - - - - - com.springsource.bundlor - com.springsource.bundlor.maven - - - - diff --git a/spring-rabbit/.settings/org.maven.ide.eclipse.prefs b/spring-rabbit/.settings/org.maven.ide.eclipse.prefs deleted file mode 100644 index 3b616447..00000000 --- a/spring-rabbit/.settings/org.maven.ide.eclipse.prefs +++ /dev/null @@ -1,9 +0,0 @@ -#Tue Jun 29 21:59:01 EDT 2010 -activeProfiles= -eclipse.preferences.version=1 -fullBuildGoals=process-test-resources -includeModules=false -resolveWorkspaceProjects=true -resourceFilterGoals=process-resources resources\:testResources -skipCompilerPlugin=true -version=1 diff --git a/spring-rabbit/pom.xml b/spring-rabbit/pom.xml deleted file mode 100644 index e04b87dd..00000000 --- a/spring-rabbit/pom.xml +++ /dev/null @@ -1,124 +0,0 @@ - - 4.0.0 - - org.springframework.amqp - spring-amqp-parent - 1.0.0.BUILD-SNAPSHOT - ../spring-amqp-parent/pom.xml - - spring-rabbit - jar - Spring RabbitMQ Support - - - com.rabbitmq - amqp-client - - - - org.springframework.amqp - spring-amqp - - - - - org.springframework - spring-aop - - - org.springframework - spring-oxm - - - org.springframework - spring-tx - - - org.springframework - spring-test - - - org.springframework.commons - spring-commons-retry - 1.0.0.BUILD-SNAPSHOT - - - - - commons-io - commons-io - - - - - org.slf4j - slf4j-api - - - org.slf4j - jcl-over-slf4j - compile - - - org.slf4j - slf4j-log4j12 - runtime - - - log4j - log4j - - - javax.mail - mail - - - javax.jms - jms - - - com.sun.jdmk - jmxtools - - - com.sun.jmx - jmxri - - - runtime - - - - javax.annotation - jsr250-api - true - - - - cglib - cglib-nodep - true - - - - org.mockito - mockito-all - test - - - - junit - junit - - - - - - - com.springsource.bundlor - com.springsource.bundlor.maven - - - - diff --git a/src/ant/upload-dist.xml b/src/ant/upload-dist.xml deleted file mode 100644 index b3d6861c..00000000 --- a/src/ant/upload-dist.xml +++ /dev/null @@ -1,48 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - diff --git a/src/assembly/distribution.xml b/src/assembly/distribution.xml deleted file mode 100644 index 6468a7a0..00000000 --- a/src/assembly/distribution.xml +++ /dev/null @@ -1,82 +0,0 @@ - - - - distribution - - zip - - true - - - - src/main/resources - - readme.txt - apache-license.txt - epl-license.txt - notice.txt - changelog.txt - - - dos - - - - target/site/reference - docs/reference - - - - target/site/apidocs - docs/javadoc - - - - spring-amqp-samples - - */target/ - - samples - - - - - - - org.springframework.amqp:spring-amqp - org.springframework.amqp:spring-erlang - org.springframework.amqp:spring-rabbit - org.springframework.amqp:spring-rabbit-admin - - - dist - false - false - - - - - - org.springframework.amqp:spring-amqp - org.springframework.amqp:spring-erlang - org.springframework.amqp:spring-rabbit - org.springframework.amqp:spring-rabbit-admin - - - sources - src - false - false - - - - diff --git a/src/docbkx/amqp.xml b/src/docbkx/amqp.xml deleted file mode 100644 index 76a3c8d8..00000000 --- a/src/docbkx/amqp.xml +++ /dev/null @@ -1,885 +0,0 @@ - - - - Using Spring AMQP - - In this chapter, we will explore interface and classes that are the - essential components for developing applications with Spring AMQP. - - - AMQP Abstractions - - The Spring AMQP project consists of a handful of modules, each - represented by a JAR in the distribution. These modules are: spring-amqp, - spring-rabbit, spring-erlang, and spring-rabbit-admin. The 'spring-amqp' - module contains the org.springframework.amqp.core package. Within that - package, you will find the classes that represent the core AMQP "model". - Our intention is to provide generic abstractions that do not rely on any - particular AMQP broker implementation or client library. End user code - will be more portable across vendor implementations as it can be developed - against the abstraction layer only. These abstractions are then used - implemented by broker-specific modules, such as 'spring-rabbit'. For the - M1 release there is only a RabbitMQ implementation however the - abstractions have been vetted in .NET using Apache Qpid in addition to - RabbitMQ. - - The overview here assumes that you are already familiar with the - basics of the AMQP specification already. If you are not, then have a look - at the resources listed in - - - Message - - The 0-8 and 0-9-1 AMQP specifications do not define an Message - class or interface. Instead, when performing an operation such as - ' - basicPublish - ', the content is passed as a byte-array argument and - additional properties are passed in as separate arguments. Spring AMQP - defines a Message class as part of a more general AMQP domain model - representation. The purpose of the Message class is to simply - encapsulate the body and properties within a single instance so that the - API can in turn be simpler. The Message class definition is quite - straightforward. - - public class Message { - - private final MessageProperties messageProperties; - - private final byte[] body; - - public Message(byte[] body, MessageProperties messageProperties) { - this.body = body; - this.messageProperties = messageProperties; - } - - public byte[] getBody() { - return this.body; - } - - public MessageProperties getMessageProperties() { - return this.messageProperties; -} - - The MessageProperties interface - defines several common properties such as 'messageId', 'timestamp', - 'contentType', and several more. Those properties can also be extended - with user-defined 'headers' by calling the setHeader(String - key, Object value) method. - - - - Exchange - - The Exchange interface represents - an AMQP Exchange, which is what a Message Producer sends to. Each - Exchange within a virtual host of a broker will have a unique name as - well as a few other properties: - - public interface Exchange { - - String getName(); - - ExchangeType getExchangeType(); - - boolean isDurable(); - - boolean isAutoDelete(); - - Map<String, Object> getArguments(); - -} - - As you can see, an Exchange also has a 'type' represented by the - enumeration ExchangeType. The basic types are: - Direct, Topic and - Fanout. In the core package you will find - implementations of the Exchange interface - for each of those types. The behavior varies across these Exchange types - in terms of how they handle bindings to Queues. A Direct exchange allows - for a Queue to be bound by a fixed routing key (often the Queue's name). - A Topic exchange supports bindings with routing patterns that may - include the '*' and '#' wildcards for 'exactly-one' and 'zero-or-more', - respectively. The Fanout exchange publishes to all Queues that are bound - to it without taking any routing key into consideration. For much more - information about Exchange types, check out . - - - The AMQP specification also requires that any broker provide a - "default" Direct Exchange that has no name. All Queues that are - declared will be bound to that default Exchange with their names as - routing keys. You will learn more about the default Exchange's usage - within Spring AMQP in . - - - - - Queue - - The Queue class represents the component - from which a Message Consumer receives Messages. Like the various - Exchange classes, our implementation is intended to be an abstract - representation of this core AMQP type. - - public class Queue { - - private final String name; - - private volatile boolean durable; - - private volatile boolean exclusive; - - private volatile boolean autoDelete; - - private volatile Map<String, Object> arguments; - - public Queue(String name) { - this.name = name; - } - - // Getters and Setters omitted for brevity - - - - Notice that the constructor takes the Queue name. Depending on the - implementation, the admin template may provide methods for generating a - uniquely named Queue. Such Queues can be useful as a "reply-to" address - or other temporary situations. For that reason, the - 'exclusive' and 'autoDelete' properties of an auto-generated Queue would - both be set to 'true'. - - - - Binding - - Given that a producer sends to an Exchange and a consumer receives - from a Queue, the bindings that connect Queues to Exchanges are critical - for connecting those producers and consumers via messaging. In Spring - AMQP, we define a Binding class to represent - those connections. Let's review the basic options for binding Queues to - Exchanges. - - You can bind a Queue to a DirectExchange with a fixed routing - key. - - new Binding(someQueue, someDirectExchange, "foo.bar") - - You can bind a Queue to a TopicExchange with a routing - pattern. - - new Binding(someQueue, someTopicExchange, "foo.*") - - You can bind a Queue to a FanoutExchange with no routing - key. - - new Binding(someQueue, someFanoutExchange) - - We also provide a BindingBuilder to - facilitate a "fluent API" style. - - Binding b = BindingBuilder.from(someQueue).to(someTopicExchange).with("foo.*"); - - - The BindingBuilder class is shown above for clarity, but this - style works well when using a static import for the 'from()' - method. - - - By itself, an instance of the Binding class is just holding the - data about a connection. In other words, it is not an "active" - component. However, as you will see later in , Binding instances can be used by the - AmqpAdmin class to actually trigger the - binding actions on the broker. Also, as you will see in that same - section, the Binding instances can be defined using Spring's - @Bean-style within @Configuration - classes. There is also a convenient base class which further simplifies - that approach for generating AMQP-related bean definitions and - recognizes the Queues, Exchanges, and Bindings so that they will all be - declared on the AMQP broker upon application startup. - - - The AmqpTemplate is also defined - within the core package. As one of the main components involved in actual - AMQP messaging, it is discussed in detail in its own section (see ). - - - - Connection and Resource Management - - Whereas the AMQP model we described in the previous section is - generic and applicable to all implementations, when we get into the - management of resources, the details are specific to the broker - implementation. Therefore, in this section, we will be focusing on code - that exists only within our "spring-rabbit" module since at this point, - RabbitMQ is the only supported implementation. - - The central component for managing a connection to the RabbitMQ - broker is the ConnectionFactory interface. - The responsibility of a ConnectionFactory - implementation is to provide an instance of - com.rabbitmq.client.Connection. The simplest - implementation we provide is - SingleConnectionFactory which establishes a single - connection that can be shared by the application. Sharing of the - connection is possible since the "unit of work" for messaging with AMQP is - actually a "channel" (in some ways, this is similar to the relationship - between a Connection and a Session in JMS). As you can imagine, the - connection instance provides a createChannel - method. When creating an instance of - SingleConnectionFactory, the 'hostname' can be - provided via the constructor. The 'username' and 'password' properties - should be provided as well. - - SingleConnectionFactory connectionFactory = new SingleConnectionFactory("somehost"); -connectionFactory.setUsername("guest"); -connectionFactory.setPassword("guest"); - -Connection connection = connectionFactory.createConnection(); - - When using XML, the configuration might look like this: - - <bean id="cf" class="org.springframework.amqp.rabbit.connection.SingleConnectionFactory"> - <constructor-arg value="somehost"/> - <property name="username" value="guest"/> - <property name="password" value="guest"/> -</bean> - - - You may also discover the - - CachingConnectionFactory - - implementation, but at this time, that code is considered - - experimental - - . We recommend sticking with - - SingleConnectionFactory - - for now as the caching implementation will most likely evolve. Support for failover of connections is also planned. - - - - - AmqpTemplate - - As with many other high-level abstractions provided by the Spring - Framework and related projects, Spring AMQP provides a "template" that - plays a central role. The interface that defines the main operations is - called AmqpTemplate. Those operations cover - the general behavior for sending and receiving Messages. In other words, - they are not unique to any implementation, hence the "AMQP" in the name. - On the other hand, there are implementations of that interface that are - tied to implementations of the AMQP protocol. Unlike JMS, which is an - interface-level API itself, AMQP is a wire-level protocol. The - implementations of that protocol provide their own client libraries, so - each implementation of the template interface will depend on a particular - client library. Currently, there is only a single implementation: - RabbitTemplate. In the examples that follow, you - will often see usage of an "AmqpTemplate", but when you look at the - configuration examples, or any code excerpts where the template is - instantiated and/or setters are invoked, you will see the implementation - type (e.g. "RabbitTemplate"). - - As mentioned above, the AmqpTemplate - interface defines all of the basic operations for sending and receiving - Messages. We will explore Message sending and reception, respectively, in - the two sections that follow. - - - - Sending messages - - When sending a Message, one can use any of the following - methods: - - void send(MessageCreator messageCreator) throws AmqpException; - -void send(String routingKey, MessageCreator messageCreator) throws AmqpException; - -void send(String exchange, String routingKey, MessageCreator messageCreator) throws AmqpException; - - We can begin our discussion with the last method listed above since - it is actually the most explicit. It allows an AMQP Exchange name to be - provided at runtime along with a routing key. The last parameter is the - callback that is responsible for actual creating of the Message instance. - An example of using this method to send a Message might look this - this: - - amqpTemplate.send("marketData.topic", "quotes.nasdaq.FOO", new MessageCreator() { - public Message createMessage() { - return new Message("12.34".getBytes(), someProperties); - } -}); - - The "exchange" property can be set on the template itself if you - plan to use that template instance to send to the same exchange most or - all of the time. In such cases, the second method listed above may be used - instead. The following example is functionally equivalent to the previous - one: - - amqpTemplate.setExchange("marketData.topic"); -amqpTemplate.send("quotes.nasdaq.FOO", new MessageCreator() { - public Message createMessage() { - return new Message("12.34".getBytes(), someProperties); - } -}); - - If both the "exchange" and "routingKey" properties are set on the - template, then the method accepting only the - MessageCreator may be used: - - amqpTemplate.setExchange("marketData.topic"); -amqpTemplate.setRoutingKey("quotes.nasdaq.FOO"); -amqpTemplate.send(new MessageCreator() { - public Message createMessage() { - return new Message("12.34".getBytes(), someProperties); - } -}); - - A better way of thinking about the exchange and routing key - properties is that the explicit method parameters will always override the - template's default values. In fact, even if you do not explicitly set - those properties on the template, there are always default values in - place. In both cases, the default is an empty String, but that is actually - a sensible default. As far as the routing key is concerned, it's not - always necessary in the first place (e.g. a Fanout Exchange). Furthermore, - a Queue may be bound to an Exchange with an empty String. Those are both - legitimate scenarios for reliance on the default empty String value for - the routing key property of the template. As far as the Exchange name is - concerned, the empty String is quite commonly used because the AMQP - specification defines the "default Exchange" as having no name. Since all - Queues are automatically bound to that default Exchange (which is a Direct - Exchange) using their name as the binding value, that second method above - can be used for simple point-to-point Messaging to any Queue through the - default Exchange. Simply provide the queue name as the "routingKey" - - either by providing the method parameter at runtime: - - RabbitTemplate template = new RabbitTemplate(); // using default no-name Exchange -template.send("queue.helloWorld", new MessageCreator() { - public Message createMessage() { - return new Message("Hello World".getBytes(), someProperties); - } -}); - - Or, if you prefer to create a template that will be used for - publishing primarily or exclusively to a single Queue, the following is - perfectly reasonable: - - RabbitTemplate template = new RabbitTemplate(); // using default no-name Exchange -template.setRoutingKey("queue.helloWorld"); // but we'll always send to this Queue -template.send(new MessageCreator() { - public Message createMessage() { - return new Message("Hello World".getBytes(), someProperties); - } -}); - - - - Receiving messages - - Message reception is always a bit more complicated than sending. The - reason is that there are two ways to receive a Message. The simpler option - is to poll for a single Message at a time with a synchronous, blocking - method call. The more complicated yet more common approach is to register - a listener that will receive Messages on-demand, asynchronously. We will - look at an example of each approach in the next two sub-sections. - - - Synchronous Reception - - The AmqpTemplate itself can be used - for synchronous Message reception. There are two 'receive' methods - available. As with the Exchange on the sending side, there is a method - that requires a queue property having been set directly on the template - itself, and there is a method that accepts a queue parameter at - runtime. - - Message receive() throws AmqpException; - -Message receive(String queueName) throws AmqpException; - - - - - - Asynchronous Reception - - - - For asynchronous Message reception, a dedicated component other - than the AmqpTemplate is involved. That - component is a container for a Message consuming callback. We will look - at the container and its properties in just a moment, but first we - should look at the callback since that is where your application code - will be integrated with the messaging system. There are a few options - for the callback. The simplest of these is to implement the - MessageListener interface: - - - - public interface MessageListener { - - void onMessage(Message message); - -} - - - - If your callback logic depends upon the AMQP Channel instance for - any reason, you may instead use the - ChannelAwareMessageListener. It looks - similar but with an extra parameter: - - - - public interface ChannelAwareMessageListener<M extends Message> { - - void onMessage(M message, Channel channel) throws Exception; - -} - - - - If you prefer to maintain a stricter separation between your - application logic and the messaging API, you can rely upon an adapter - implementation that is provided by the framework. This is often referred - to as "Message-driven POJO" support. When using the adapter, you only - need to provide a reference to the instance that the adapter itself - should invoke. - - - - MessageListener listener = new MessageListenerAdapter(somePojo); - - Now that you've seen the various options for the Message-listening callback, we can turn our attention to the container. Basically, the container handles the "active" responsibilities so that the listener callback can remain passive. The container is an example of a "lifecycle" component. It provides methods for starting and stopping. When configuring the container, you are essentially bridging the gap between an AMQP Queue and the - - MessageListener - - instance. You must provide a reference to the - - ConnectionFactory - - and the queue name or Queue instance(s) from which that listener should consume Messages. Here is the most basic example using the default implementation, - - SimpleMessageListenerContainer - - : - - SimpleMessageListenerContainer container = new SimpleMessageListenerContainer(); -container.setConnectionFactory(rabbitConnectionFactory); -container.setQueueName("some.queue"); -container.setMessageListener(someListener); - - As an "active" component, it's most common to create the listener container with a bean definition so that it can simply run in the background. This can be done via XML: - - <bean class="org.springframework.amqp.rabbit.listener.SimpleMessageListenerContainer"> - <property name="connectionFactory" ref="rabbitConnectionFactory"/> - <property name="queueName" value="some.queue"/> - <property name="messageListener" ref="someListener"/> -</bean> - - Or, you may prefer to use the @Configuration style which will look very similar to the actual code snippet above: - - @Configuration -public class ExampleAmqpConfiguration { - - @Bean - public MessageListenerContainer messageListenerContainer { - SimpleMessageListenerContainer container = new SimpleMessageListenerContainer(); - container.setConnectionFactory(rabbitConnectionFactory()); - container.setQueueName("some.queue"); - container.setMessageListener(exampleListener()); - return container; - } - - @Bean - public ConnectionFactory rabbitConnectionFactory() { - SingleConnectionFactory connectionFactory = new SingleConnectionFactory("localhost"); - connectionFactory.setUsername("guest"); - connectionFactory.setPassword("guest"); - return connectionFactory; - } - - @Bean - public MessageListener exampleListener() { - return new MessageListener() { - public void onMessage(Message message) { - System.out.println("received: " + message) - } - } - } -} - - - - - - - Message Converters - - The AmqpTemplate also defines several - methods for sending and receiving Messages that will delegate to a - MessageConverter. The - MessageConverter itself is quite - straightforward. It provides a single method for each direction: one for - converting to a Message and another for converting - from a Message. Notice that when converting to a - Message, you may also provide properties in addition to the object. The - "object" parameter typically corresponds to the Message body. - - public interface MessageConverter { - - Message toMessage(Object object, MessageProperties messageProperties) - throws MessageConversionException; - - Object fromMessage(Message message) throws MessageConversionException; - -} - - The relevant Message-sending methods on the - AmqpTemplate are listed below. They are - simpler than the methods we discussed previously because they do not - require the MessageCreator callback. Instead, the MessageConverter is - responsible for "creating" each Message by converting the provided object - to the byte array for the Message body and then adding any provided - MessageProperties. - - void convertAndSend(Object message) throws AmqpException; - -void convertAndSend(String routingKey, Object message) throws AmqpException; - -void convertAndSend(String exchange, String routingKey, Object message) throws AmqpException; - -void convertAndSend(Object message, MessagePostProcessor messagePostProcessor) throws AmqpException; - -void convertAndSend(String routingKey, Object message, MessagePostProcessor messagePostProcessor) - throws AmqpException; - -void convertAndSend(String exchange, String routingKey, Object message, - MessagePostProcessor messagePostProcessor) throws AmqpException; - - On the receiving side, there are only two methods: one that accepts - the queue name and one that relies on the template's "queue" property - having been set. - - Object receiveAndConvert() throws AmqpException; - -Object receiveAndConvert(String queueName) throws AmqpException; - - - SimpleMessageConverter - - The default implementation of the - MessageConverter strategy is called - SimpleMessageConverter. This is the converter - that will be used by an instance of RabbitTemplate if you do not - explicitly configure an alternative. It handles text-based content, - serialized Java objects, and simple byte arrays. - - - Converting From a Message - - If the content type of the input Message begins with "text" - (e.g. "text/plain"), it will also check for the content-encoding - property to determine the charset to be used when converting the - Message body byte array to a Java String. If no content-encoding - property had been set on the input Message, it will use the "UTF-8" - charset by default. If you need to override that default setting, you - can configure an instance of - SimpleMessageConverter, set its - "defaultCharset" property and then inject that into a - RabbitTemplate instance. - - If the content-type property value of the input Message is set - to "application/x-java-serialized-object", the - SimpleMessageConverter will attempt to - deserialize (rehydrate) the byte array into a Java object. While that - might be useful for simple prototyping, it's generally not recommended - to rely on Java serialization since it leads to tight coupling between - the producer and consumer. Of course, it also rules out usage of - non-Java systems on either side. With AMQP being a wire-level - protocol, it would be unfortunate to lose much of that advantage with - such restrictions. In the next two sections, we'll explore some - alternatives for passing rich domain object content without relying on - Java serialization. - - For all other content-types, the - SimpleMessageConverter will return the Message - body content directly as a byte array. - - - - Converting To a Message - - When converting to a Message from an arbitrary Java Object, the - SimpleMessageConverter likewise deals with byte - arrays, Strings, and Serializable instances. It will convert each of - these to bytes (in the case of byte arrays, there is nothing to - convert), and it will set the content-type property accordingly. If - the Object to be converted does not match one of those types, the - Message body will be null. - - - - - JsonMessageConverter - - As mentioned in the previous section, relying on Java - serialization is generally not recommended. One rather common - alternative that is more flexible and portable across different - languages and platforms is JSON (JavaScript Object Notation). An - implementation is available and can be configured on any - RabbitTemplate instance to override its usage of - the SimpleMessageConverter default. - - <bean class="org.springframework.amqp.rabbit.core.RabbitTemplate"> - <property name="connectionFactory" ref="rabbitConnectionFactory"/> - <property name="messageConverter"> - <bean class="org.springframework.amqp.support.converter.JsonMessageConverter"> - <!-- if necessary, override the DefaultClassMapper --> - <property name="classMapper" ref="customClassMapper"/> - </bean> - </property> -</bean> - - - - MarshallingMessageConverter - - Yet another option is the - MarshallingMessageConverter. It delegates to the - Spring OXM library's implementations of the - Marshaller and - Unmarshaller strategy interfaces. You can - read more about that library here. - In terms of configuration, it's most common to provide the constructor - argument only since most implementations of - Marshaller will also implement - Unmarshaller. - - <bean class="org.springframework.amqp.rabbit.core.RabbitTemplate"> - <property name="connectionFactory" ref="rabbitConnectionFactory"/> - <property name="messageConverter"> - <bean class="org.springframework.amqp.support.converter.MarshallingMessageConverter"> - <constructor-arg ref="someImplemenationOfMarshallerAndUnmarshaller"/> - </bean> - </property> -</bean> - - - - - Configuring the broker - - The AMQP specification describes how the protocol can be used to - configure Queues, Exchanges and Bindings on the broker. These operations - which are portable from the 0.8 specification and higher are present in - the AmqpAdmin interface in the org.springframework.amqp.core package. The - RabbitMQ implementation of that class is RabbitAdmin located in the - org.springframework.amqp.rabbit.core package. Any many configuration and - management functions are broker specific and not included in the AMQP - specification, the interface RabbitBrokerOperations and its implementation - RabbitBrokerAdmin located in the org.springframework.amqp.rabbit.admin - package is provided to fill that gap. - - The AmqpAdmin interface is based on using the Spring AMQP domain - abstractions and is shown below: - - public interface AmqpAdmin { - - // Exchange Operations - - void declareExchange(Exchange exchange); - - void deleteExchange(String exchangeName); - - // Queue Operations - - Queue declareQueue(); - - void declareQueue(Queue queue); - - void deleteQueue(String queueName); - - void deleteQueue(String queueName, boolean unused, boolean empty); - - void purgeQueue(String queueName, boolean noWait); - - // Binding Operations - - void declareBinding(Binding binding); - -} - - The declareQueue() method defined a queue on the broker whose name - is automatically created. The additional properties of this auto-generated - queue are exclusive=true, autoDelete=true, and durable=false. - Removing a binding was not introduced until the 0.9 version of - the AMQP spec. - - - The RabbitMQ implementation of this interface is RabbitAdmin which - when configured using Spring XML would look like this:<bean id="cf" class="org.springframework.amqp.rabbit.connection.SingleConnectionFactory"> - <constructor-arg value="localhost"/> - <property name="username" value="guest"/> - <property name="password" value="guest"/> -</bean> - -<bean id="amqpAdmin" class="org.springframework.amqp.rabbit.core.RabbitAdmin"> - <constructor-arg ref="cf"/> -</bean> - - The class AbstractAmqpConfiguration can also be used to configure an - instance of the AmqpAmin interface. The base class - AbstractAmqpConfiguration is located in the package - org.springframework.amqp.config and is shown in part below. - - @Configuration -public abstract class AbstractAmqpConfiguration implements ApplicationContextAware, SmartLifecycle { - - @Bean - public abstract AmqpAdmin amqpAdmin(); - - // the rest omitted for brevity. -} - - The part that is omitted is related to the implementation of - SmartLifecycle which is responsible for querying the container for all - Queues, Exchanges, and Bindings that are defined in the DI container and - declaring them to the broker. Thus if you are using the @Configuration - style of configuration, you can simply create Queue, Exchange, and Binding - bean definitions and they will be declared to the broker once the - application has started. - - If you are using RabbitMQ as your broker, the additional abstract - @Configuration class can be used to bootstrap an implementation of - AmqpAdmin as shown below - - @Configuration -public abstract class AbstractRabbitConfiguration extends AbstractAmqpConfiguration { - - @Bean - public abstract RabbitTemplate rabbitTemplate(); - - @Bean - public AmqpAdmin amqpAdmin() { - this.amqpAdmin = new RabbitAdmin(rabbitTemplate().getConnectionFactory()); - return this.amqpAdmin; - } -} - - This leaves it up to you to provide an implementation of the - rabbitTemplate method in your application specific subclass. For example, - using the Stock sample application, there is the @Configuration class - AbstractStockRabbitConfiguration which in turn has - RabbitClientConfiguration and RabbitServerConfiguration subclasses. The - code for AbstractStockRabbitConfiguration is show below - - @Configuration -public abstract class AbstractStockAppRabbitConfiguration extends AbstractRabbitConfiguration { - - @Bean - public ConnectionFactory connectionFactory() { - SingleConnectionFactory connectionFactory = new SingleConnectionFactory("localhost"); - connectionFactory.setUsername("guest"); - connectionFactory.setPassword("guest"); - return connectionFactory; - } - - @Bean - public RabbitTemplate rabbitTemplate() { - RabbitTemplate template = new RabbitTemplate(connectionFactory()); - template.setMessageConverter(jsonMessageConverter()); - configureRabbitTemplate(template); - return template; - } - - @Bean - public MessageConverter jsonMessageConverter() { - return new JsonMessageConverter(); - } - - @Bean - public TopicExchange marketDataExchange() { - return new TopicExchange("app.stock.marketdata"); - } - - // additional code omitted for brevity - -} - - In the Stock application, the server is configured using the - following @Configuration class - - @Configuration -public class RabbitServerConfiguration extends AbstractStockAppRabbitConfiguration { - - @Bean - public Queue stockRequestQueue() { - return new Queue("app.stock.request"); - } -} - - This is the end of the whole inheritance chain of @Configuration - classes. The end result is the the TopicExchange and Queue will be - declared to the broker upon application startup. There is no binding of - the TopicExchange to a queue in the server configuration, as that is done - in the client application. The stock request queue however is - automatically bound to the AMQP default exchange - this behavior is - defined by the specification. - - The client @Configuration class is a little more interesting and is - show below. - - @Configuration -public class RabbitClientConfiguration extends AbstractStockAppRabbitConfiguration { - - @Value("${stocks.quote.pattern}") - private String marketDataRoutingKey; - - @Bean - public Queue marketDataQueue() { - return amqpAdmin().declareQueue(); - } - - /** - * Binds to the market data exchange. Interested in any stock quotes. - */ - @Bean - public Binding marketDataBinding() { - return BindingBuilder.from( - marketDataQueue()).to(marketDataExchange()).with(marketDataRoutingKey); - } - - // additional code omitted for brevity - -} - - The client is declaring another queue via the declareQueue() method - on the AmqpAdmin, and it binds that queue to the market data exchange with - a routing pattern that is externalized in a properties file. - - - - Exception Handling - - Many operations with the RabbitMQ Java client can throw checked Exceptions. For example, there are a lot of cases where IOExceptions may be thrown. The RabbitTemplate, SimpleMessageListenerContainer, and other Spring AMQP components will catch those Exceptions and convert into one of the Exceptions within our runtime hierarchy. Those are defined in the 'org.springframework.amqp' package, and AmqpException is the base of the hierarchy. - - - - JMX Monitoring - - All the methods in the RabbitBrokerAdmin class are exposed through - JMX through the use of the @ManagedOperations annotation. Please refer to - the sample application for how to configure spring to export the - RabbitBrokerAdmin. - - diff --git a/src/docbkx/bibliography.xml b/src/docbkx/bibliography.xml deleted file mode 100644 index c8baa1fd..00000000 --- a/src/docbkx/bibliography.xml +++ /dev/null @@ -1,24 +0,0 @@ - - - - Bibliography - - - - - Ericsson AB - - - - <ulink - url="http://www.erlang.org/doc/apps/jinterface/jinterface.pdf">jinterface - User Guide</ulink> - - - Ericson AB - - - 2000 - - diff --git a/src/docbkx/erlang.xml b/src/docbkx/erlang.xml deleted file mode 100644 index e951fecf..00000000 --- a/src/docbkx/erlang.xml +++ /dev/null @@ -1,122 +0,0 @@ - - - - Erlang integration - -
- Introduction - - There is an open source project called JInterface that provides a - way for Java applications to communicate with an Erlang process. The API - is very low level and rather tedious to use and throws checked exceptions. - The Spring Erlang module makes accessing functions in Erlang from Java - easy, often they can be one liners. -
- -
- Communicating with Erlang processes - - TODO - -
- Connection Management - - TODO -
- -
- Executing RPC - - The interface ErlangOperations is the high level API for - interacting with an Erlang process. - - public interface ErlangOperations { - - <T> T execute(ConnectionCallback<T> action) throws OtpException; - - OtpErlangObject executeErlangRpc(String module, String function, OtpErlangList args) - throws OtpException; - - OtpErlangObject executeErlangRpc(String module, String function, OtpErlangObject... args) - throws OtpException; - - OtpErlangObject executeRpc(String module, String function, Object... args) - throws OtpException; - - Object executeAndConvertRpc(String module, String function, - ErlangConverter converterToUse, Object... args) throws OtpException; - - // Sweet! - Object executeAndConvertRpc(String module, String function, Object... args) - throws OtpException; - -} - - The class that implements this interface is called - ErlangTemplate. There are a few convenience - methods, most notably executeAndConvertRpc, as - well as the execute method which gives you - access to the 'native' API of the JInterface project. For simple - functions, you can invoke executeAndConvertRpc - with the appropriate Erlang module name, function, and arguments in a - one-liner. For example, here is the implementation of the - RabbitBrokerAdmin method 'DeleteUser' - - - - As the JInterface library uses specific classes such as - OtpErlangDouble, OtpErlangString to represent the primitive types in - Erlang RPC calls, there is a converter class that works in concert with - ErlangTemplate that knows how to translate from Java primitive types to - their Erlang class equivalents. You can also create custom converters - and register them with the ErlangTemplate to handle more complex data - format translations. -
- -
- ErlangConverter - - The ErlangConverter interface is show below - - -
-
- -
- Exceptions - - The JInterface checked exception hierarchy is translated into a - parallel runtime exception hierarchy when executing operations through - ErlangTemplate. - -
- -
diff --git a/src/docbkx/further-reading.xml b/src/docbkx/further-reading.xml deleted file mode 100644 index 2bdff069..00000000 --- a/src/docbkx/further-reading.xml +++ /dev/null @@ -1,30 +0,0 @@ - - - - Further Reading - - - For those who are not familiar with AMQP, the - specification - is actually quite readable. It is of course the authoritative source of information, and the Spring - AMQP code should be very easy to understand for anyone who is familiar with the spec. Our current - implementation of the RabbitMQ support is based on their 1.8.x version, and it officially supports - AMQP 0.8. However, we recommend reading the 0.9.1 document. The differences are minor (mostly - clarifications in fact), and the document itself is more readable. - - - - There are many great articles, presentations, and blogs available on the - RabbitMQ Getting Started page. - Since that is currently the only supported implementation for Spring AMQP, we also - recommend that as a general starting point for all broker-related concerns. - - - - Finally, be sure to visit the Spring AMQP - Forum if you have questions - or suggestions. With this first milestone release, we are looking forward to a lot of community feedback! - - - diff --git a/src/docbkx/index.xml b/src/docbkx/index.xml deleted file mode 100644 index 5eb8d22e..00000000 --- a/src/docbkx/index.xml +++ /dev/null @@ -1,89 +0,0 @@ - - - - - Spring AMQP - Reference Documentation - &version; - - - - Mark - Pollack - - - Mark - Fisher - - - Oleg - Zhurakousky - - - - - - Copies of this document may be made for your own use and for distribution - to others, provided that you do not charge any fee for such copies and - further provided that each copy contains this Copyright Notice, whether - distributed in print or electronically. - - - - - - - - - - - - Reference - - - This part of the reference documentation details the various components - that comprise Spring AMQP. The main chapter - covers the core classes to develop an AMQP application. It part also - includes a chapter on integration with - Erlang and a chapter - about the sample applications. - - - - - - - - Spring Integration - Reference - - - This part of the reference documentation details the - integration with the Spring Integration project. - - - - - - Other Resources - - - In addition to this reference documentation, there exist a number of - other resources that may help you learn about AMQP. - - - - - - diff --git a/src/docbkx/preface.xml b/src/docbkx/preface.xml deleted file mode 100644 index c94977df..00000000 --- a/src/docbkx/preface.xml +++ /dev/null @@ -1,8 +0,0 @@ - - - - Preface - - The Spring AMQP project applies core Spring concepts to the development of AMQP-based messaging solutions. We provide a "template" as a high-level abstraction for sending and receiving messages. We also provide support for Message-driven POJOs. These libraries facilitate management of AMQP resources while promoting the use of dependency injection and declarative configuration. In all of these cases, you will see similarities to the JMS support in the Spring Framework. The project consists of both Java and .NET versions. This manual is dedicated to the Java version. For links to the .NET version's manual or any other project-related information visit the Spring AMQP project homepage. - diff --git a/src/docbkx/quick-tour.xml b/src/docbkx/quick-tour.xml deleted file mode 100644 index bb437867..00000000 --- a/src/docbkx/quick-tour.xml +++ /dev/null @@ -1,12 +0,0 @@ - - - - Quick Tour for the impatient - -
- Introduction - - This is the 5 minute tour to get started with Spring AMQP. -
-
diff --git a/src/docbkx/resources/css/highlight.css b/src/docbkx/resources/css/highlight.css deleted file mode 100644 index ffefef72..00000000 --- a/src/docbkx/resources/css/highlight.css +++ /dev/null @@ -1,35 +0,0 @@ -/* - code highlight CSS resemblign the Eclipse IDE default color schema - @author Costin Leau -*/ - -.hl-keyword { - color: #7F0055; - font-weight: bold; -} - -.hl-comment { - color: #3F5F5F; - font-style: italic; -} - -.hl-multiline-comment { - color: #3F5FBF; - font-style: italic; -} - -.hl-tag { - color: #3F7F7F; -} - -.hl-attribute { - color: #7F007F; -} - -.hl-value { - color: #2A00FF; -} - -.hl-string { - color: #2A00FF; -} \ No newline at end of file diff --git a/src/docbkx/resources/css/html.css b/src/docbkx/resources/css/html.css deleted file mode 100644 index 10936f33..00000000 --- a/src/docbkx/resources/css/html.css +++ /dev/null @@ -1,421 +0,0 @@ -body { - text-align: justify; - margin-right: 2em; - margin-left: 2em; -} - -a, - a[accesskey^ - -= -"h" -] -, -a[accesskey^ - -= -"n" -] -, -a[accesskey^ - -= -"u" -] -, -a[accesskey^ - -= -"p" -] -{ -font-family: Verdana, Arial, helvetica, sans-serif - -; -font-size: - -12 -px - -; -color: #003399 - -; -} - -a:active { - color: #003399; -} - -a:visited { - color: #888888; -} - -p { - font-family: Verdana, Arial, sans-serif; -} - -dt { - font-family: Verdana, Arial, sans-serif; - font-size: 12px; -} - -p, dl, dt, dd, blockquote { - color: #000000; - margin-bottom: 3px; - margin-top: 3px; - padding-top: 0px; -} - -ol, ul, p { - margin-top: 6px; - margin-bottom: 6px; -} - -p, blockquote { - font-size: 90%; -} - -p.releaseinfo { - font-size: 100%; - font-weight: bold; - font-family: Verdana, Arial, helvetica, sans-serif; - padding-top: 10px; -} - -p.pubdate { - font-size: 120%; - font-weight: bold; - font-family: Verdana, Arial, helvetica, sans-serif; -} - -td { - font-size: 80%; -} - -td, th, span { - color: #000000; -} - -td[width^ - -= -"40%" -] -{ -font-family: Verdana, Arial, helvetica, sans-serif - -; -font-size: - -12 -px - -; -color: #003399 - -; -} - -table[summary^ - -= -"Navigation header" -] -tbody tr th[colspan^ - -= -"3" -] -{ -font-family: Verdana, Arial, helvetica, sans-serif - -; -} - -blockquote { - margin-right: 0px; -} - -h1, h2, h3, h4, h6, H6 { - color: #000000; - font-weight: 500; - margin-top: 0px; - padding-top: 14px; - font-family: Verdana, Arial, helvetica, sans-serif; - margin-bottom: 0px; -} - -h2.title { - font-weight: 800; - margin-bottom: 8px; -} - -h2.subtitle { - font-weight: 800; - margin-bottom: 20px; -} - -.firstname, .surname { - font-size: 12px; - font-family: Verdana, Arial, helvetica, sans-serif; -} - -table { - border-collapse: collapse; - border-spacing: 0; - border: 1px black; - empty-cells: hide; - margin: 10px 0px 30px 50px; - width: 90%; -} - -div.table { - margin: 30px 0px 30px 0px; - border: 1px dashed gray; - padding: 10px; -} - -div .table-contents table { - border: 1px solid black; -} - -div.table > p.title { - padding-left: 10px; -} - -table[summary^ - -= -"Navigation footer" -] -{ -border-collapse: collapse - -; -border-spacing: - -0 -; -border: - -1 -px black - -; -empty-cells: hide - -; -margin: - -0 -px - -; -width: - -100 -% -; -} - -table[summary^ - -= -"Note" -] -, -table[summary^ - -= -"Warning" -] -, -table[summary^ - -= -"Tip" -] -{ -border-collapse: collapse - -; -border-spacing: - -0 -; -border: - -1 -px black - -; -empty-cells: hide - -; -margin: - -10 -px - -0 -px - -10 -px - -- -20 -px - -; -width: - -100 -% -; -} - -td { - padding: 4pt; - font-family: Verdana, Arial, helvetica, sans-serif; -} - -div.warning TD { - text-align: justify; -} - -h1 { - font-size: 150%; -} - -h2 { - font-size: 110%; -} - -h3 { - font-size: 100%; - font-weight: bold; -} - -h4 { - font-size: 90%; - font-weight: bold; -} - -h5 { - font-size: 90%; - font-style: italic; -} - -h6 { - font-size: 100%; - font-style: italic; -} - -tt { - font-size: 110%; - font-family: "Courier New", Courier, monospace; - color: #000000; -} - -.navheader, .navfooter { - border: none; -} - -div.navfooter table { - border: dashed gray; - border-width: 1px 1px 1px 1px; - background-color: #cde48d; -} - -pre { - font-size: 110%; - padding: 5px; - border-style: solid; - border-width: 1px; - border-color: #CCCCCC; - background-color: #f3f5e9; -} - -ul, ol, li { - list-style: disc; -} - -hr { - width: 100%; - height: 1px; - background-color: #CCCCCC; - border-width: 0px; - padding: 0px; -} - -.variablelist { - padding-top: 10px; - padding-bottom: 10px; - margin: 0; -} - -.term { - font-weight: bold; -} - -.mediaobject { - padding-top: 30px; - padding-bottom: 30px; -} - -.legalnotice { - font-family: Verdana, Arial, helvetica, sans-serif; - font-size: 12px; - font-style: italic; -} - -.sidebar { - float: right; - margin: 10px 0px 10px 30px; - padding: 10px 20px 20px 20px; - width: 33%; - border: 1px solid black; - background-color: #F4F4F4; - font-size: 14px; -} - -.property { - font-family: "Courier New", Courier, monospace; -} - -a code { - font-family: Verdana, Arial, monospace; - font-size: 12px; -} - -td code { - font-size: 110%; -} - -div.note * td, - div.tip * td, - div.warning * td, - div.calloutlist * td { - text-align: justify; - font-size: 100%; -} - -.programlisting .interfacename, - .programlisting .literal, - .programlisting .classname { - font-size: 95%; -} - -.title .interfacename, - .title .literal, - .title .classname { - font-size: 130%; -} - -/* everything in a is displayed in a coloured, comment-like font */ -.programlisting * .lineannotation, - .programlisting * .lineannotation * { - color: green; -} diff --git a/src/docbkx/resources/css/stylesheet.css b/src/docbkx/resources/css/stylesheet.css deleted file mode 100644 index 77569070..00000000 --- a/src/docbkx/resources/css/stylesheet.css +++ /dev/null @@ -1,99 +0,0 @@ -@IMPORT url("highlight.css"); - -html { - padding: 0pt; - margin: 0pt; -} - -body { - margin-left: 10%; - margin-right: 10%; - font-family: Arial, Sans-serif; -} - -div { - margin: 0pt; -} - -p { - text-align: justify; -} - -hr { - border: 1px solid gray; - background: gray; -} - -h1,h2,h3,h4 { - color: #234623; - font-family: Arial, Sans-serif; -} - -pre { - line-height: 1.0; - color: black; -} - -pre.programlisting { - font-size: 10pt; - padding: 7pt 3pt; - border: 1pt solid black; - background: #eeeeee; - clear: both; -} - -div.table { - margin: 1em; - padding: 0.5em; - text-align: center; -} - -div.table table { - display: table; - width: 100%; -} - -div.table td { - padding-left: 7px; - padding-right: 7px; -} - -.sidebar { - float: right; - margin: 10px 0 10px 30px; - padding: 10px 20px 20px 20px; - width: 33%; - border: 1px solid black; - background-color: #F4F4F4; - font-size: 14px; -} - -.mediaobject { - padding-top: 30px; - padding-bottom: 30px; -} - -.legalnotice { - font-family: Verdana, Arial, helvetica, sans-serif; - font-size: 12px; - font-style: italic; -} - -p.releaseinfo { - font-size: 100%; - font-weight: bold; - font-family: Verdana, Arial, helvetica, sans-serif; - padding-top: 10px; -} - -p.pubdate { - font-size: 120%; - font-weight: bold; - font-family: Verdana, Arial, helvetica, sans-serif; -} - -span.productname { - font-size: 200%; - font-weight: bold; - font-family: Verdana, Arial, helvetica, sans-serif; -} diff --git a/src/docbkx/resources/images/callouts/1.png b/src/docbkx/resources/images/callouts/1.png deleted file mode 100644 index 7d473430..00000000 Binary files a/src/docbkx/resources/images/callouts/1.png and /dev/null differ diff --git a/src/docbkx/resources/images/callouts/10.png b/src/docbkx/resources/images/callouts/10.png deleted file mode 100644 index 997bbc82..00000000 Binary files a/src/docbkx/resources/images/callouts/10.png and /dev/null differ diff --git a/src/docbkx/resources/images/callouts/11.png b/src/docbkx/resources/images/callouts/11.png deleted file mode 100644 index ce47dac3..00000000 Binary files a/src/docbkx/resources/images/callouts/11.png and /dev/null differ diff --git a/src/docbkx/resources/images/callouts/12.png b/src/docbkx/resources/images/callouts/12.png deleted file mode 100644 index 31daf4e2..00000000 Binary files a/src/docbkx/resources/images/callouts/12.png and /dev/null differ diff --git a/src/docbkx/resources/images/callouts/13.png b/src/docbkx/resources/images/callouts/13.png deleted file mode 100644 index 14021a89..00000000 Binary files a/src/docbkx/resources/images/callouts/13.png and /dev/null differ diff --git a/src/docbkx/resources/images/callouts/14.png b/src/docbkx/resources/images/callouts/14.png deleted file mode 100644 index 64014b75..00000000 Binary files a/src/docbkx/resources/images/callouts/14.png and /dev/null differ diff --git a/src/docbkx/resources/images/callouts/15.png b/src/docbkx/resources/images/callouts/15.png deleted file mode 100644 index 0d65765f..00000000 Binary files a/src/docbkx/resources/images/callouts/15.png and /dev/null differ diff --git a/src/docbkx/resources/images/callouts/2.png b/src/docbkx/resources/images/callouts/2.png deleted file mode 100644 index 5d09341b..00000000 Binary files a/src/docbkx/resources/images/callouts/2.png and /dev/null differ diff --git a/src/docbkx/resources/images/callouts/3.png b/src/docbkx/resources/images/callouts/3.png deleted file mode 100644 index ef7b7004..00000000 Binary files a/src/docbkx/resources/images/callouts/3.png and /dev/null differ diff --git a/src/docbkx/resources/images/callouts/4.png b/src/docbkx/resources/images/callouts/4.png deleted file mode 100644 index adb8364e..00000000 Binary files a/src/docbkx/resources/images/callouts/4.png and /dev/null differ diff --git a/src/docbkx/resources/images/callouts/5.png b/src/docbkx/resources/images/callouts/5.png deleted file mode 100644 index 4d7eb460..00000000 Binary files a/src/docbkx/resources/images/callouts/5.png and /dev/null differ diff --git a/src/docbkx/resources/images/callouts/6.png b/src/docbkx/resources/images/callouts/6.png deleted file mode 100644 index 0ba694af..00000000 Binary files a/src/docbkx/resources/images/callouts/6.png and /dev/null differ diff --git a/src/docbkx/resources/images/callouts/7.png b/src/docbkx/resources/images/callouts/7.png deleted file mode 100644 index 472e96f8..00000000 Binary files a/src/docbkx/resources/images/callouts/7.png and /dev/null differ diff --git a/src/docbkx/resources/images/callouts/8.png b/src/docbkx/resources/images/callouts/8.png deleted file mode 100644 index 5e60973c..00000000 Binary files a/src/docbkx/resources/images/callouts/8.png and /dev/null differ diff --git a/src/docbkx/resources/images/callouts/9.png b/src/docbkx/resources/images/callouts/9.png deleted file mode 100644 index a0676d26..00000000 Binary files a/src/docbkx/resources/images/callouts/9.png and /dev/null differ diff --git a/src/docbkx/resources/images/logo.png b/src/docbkx/resources/images/logo.png deleted file mode 100644 index a9f6d959..00000000 Binary files a/src/docbkx/resources/images/logo.png and /dev/null differ diff --git a/src/docbkx/resources/images/xdev-spring_logo.jpg b/src/docbkx/resources/images/xdev-spring_logo.jpg deleted file mode 100644 index 622962ee..00000000 Binary files a/src/docbkx/resources/images/xdev-spring_logo.jpg and /dev/null differ diff --git a/src/docbkx/resources/xsl/fopdf.xsl b/src/docbkx/resources/xsl/fopdf.xsl deleted file mode 100644 index 6ca1a684..00000000 --- a/src/docbkx/resources/xsl/fopdf.xsl +++ /dev/null @@ -1,418 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Copyright © 2005-2007 - - - , - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -5em - -5em - - - - - - - - - - - Spring-WS ( - - ) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 1 - 0 - 1 - - 1 - - - - - - book toc - - - - 2 - - - - - - - - - - 0 - 0 - 0 - - - 5mm - 10mm - 10mm - - 15mm - 10mm - 0mm - - 18mm - 18mm - - - 0pc - - - - - justify - false - - - 11 - 8 - - - 1.4 - - - - - - - 0.8em - - - - - - 17.4cm - - - - 4pt - 4pt - 4pt - 4pt - - - - 0.1pt - 0.1pt - - - - - 1 - - - - - - - - left - bold - - - pt - - - - - - - - - - - - - - - 0.8em - 0.8em - 0.8em - - - pt - - 0.1em - 0.1em - 0.1em - - - 0.6em - 0.6em - 0.6em - - - pt - - 0.1em - 0.1em - 0.1em - - - 0.4em - 0.4em - 0.4em - - - pt - - 0.1em - 0.1em - 0.1em - - - - - bold - - - pt - - false - 0.4em - 0.6em - 0.8em - - - - - - - - - pt - - - - - 1em - 1em - 1em - #444444 - solid - 0.1pt - 0.5em - 0.5em - 0.5em - 0.5em - 0.5em - 0.5em - - - - 1 - - #F0F0F0 - - - - - - 0 - 1 - - - 90 - - - - - '1' - - - - - - - figure after - example before - equation before - table before - procedure before - - - - 1 - - - - 0.8em - 0.8em - 0.8em - 0.1em - 0.1em - 0.1em - - - - - - - - - - - - - - - - - diff --git a/src/docbkx/resources/xsl/html.xsl b/src/docbkx/resources/xsl/html.xsl deleted file mode 100644 index aa7930ba..00000000 --- a/src/docbkx/resources/xsl/html.xsl +++ /dev/null @@ -1,91 +0,0 @@ - - - - - - - - - html.css - - - 1 - 0 - 1 - 0 - - - - - - book toc - - - - 3 - - - - - 1 - - - - - - - 0 - - - 90 - - - - - 0 - - - - - figure after - example before - equation before - table before - procedure before - - - - , - - - - - - - - -
-

Authors

-

- -

-
- -
diff --git a/src/docbkx/resources/xsl/html/html_chunk.xsl b/src/docbkx/resources/xsl/html/html_chunk.xsl deleted file mode 100644 index 81e6ab23..00000000 --- a/src/docbkx/resources/xsl/html/html_chunk.xsl +++ /dev/null @@ -1,136 +0,0 @@ - - - - - - - '5' - - - - 1 - 0 - 1 - - - - images/ - .gif - - 120 - images/callouts/ - .gif - - - css/stylesheet.css - text/css - book toc,title - - text-align: left - - - - - - - - - - - 3 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Begin Google Analytics code - - - End Google Analytics code - - - - - Begin LoopFuse code - - - End LoopFuse code - - - \ No newline at end of file diff --git a/src/docbkx/resources/xsl/html/titlepage.xml b/src/docbkx/resources/xsl/html/titlepage.xml deleted file mode 100644 index 09539c06..00000000 --- a/src/docbkx/resources/xsl/html/titlepage.xml +++ /dev/null @@ -1,61 +0,0 @@ - - - - - - - - - - - - - <subtitle/> - <!-- <corpauthor/> - <authorgroup/> - <author/> - <mediaobject/> --> - <othercredit/> - <releaseinfo/> - <copyright/> - <legalnotice/> - <pubdate/> - <revision/> - <revhistory/> - <abstract/> - </t:titlepage-content> - - <t:titlepage-content t:side="verso"> - </t:titlepage-content> - - <t:titlepage-separator> - <hr/> - </t:titlepage-separator> - - <t:titlepage-before t:side="recto"> - </t:titlepage-before> - - <t:titlepage-before t:side="verso"> - </t:titlepage-before> -</t:titlepage> - -</t:templates> diff --git a/src/docbkx/resources/xsl/html_chunk.xsl b/src/docbkx/resources/xsl/html_chunk.xsl deleted file mode 100644 index 59016d81..00000000 --- a/src/docbkx/resources/xsl/html_chunk.xsl +++ /dev/null @@ -1,208 +0,0 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- - This is the XSL HTML configuration file for the Spring Reference Documentation. ---> -<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" - xmlns:fo="http://www.w3.org/1999/XSL/Format" - version="1.0"> - - <xsl:import href="urn:docbkx:stylesheet"/> - <!--################################################### - HTML Settings - ################################################### --> - <xsl:param name="chunk.section.depth">'5'</xsl:param> - <xsl:param name="use.id.as.filename">'1'</xsl:param> - <!-- These extensions are required for table printing and other stuff --> - <xsl:param name="use.extensions">1</xsl:param> - <xsl:param name="tablecolumns.extension">0</xsl:param> - <xsl:param name="callout.extensions">1</xsl:param> - <xsl:param name="graphicsize.extension">0</xsl:param> - <!--################################################### - Table Of Contents - ################################################### --> - <!-- Generate the TOCs for named components only --> - <xsl:param name="generate.toc"> - book toc - </xsl:param> - <!-- Show only Sections up to level 3 in the TOCs --> - <xsl:param name="toc.section.depth">3</xsl:param> - <!--################################################### - Labels - ################################################### --> - <!-- Label Chapters and Sections (numbering) --> - <xsl:param name="chapter.autolabel">1</xsl:param> - <xsl:param name="section.autolabel" select="1"/> - <xsl:param name="section.label.includes.component.label" select="1"/> - <!--################################################### - Callouts - ################################################### --> - <!-- Place callout marks at this column in annotated areas --> - <xsl:param name="callout.graphics">1</xsl:param> - <xsl:param name="callout.defaultcolumn">90</xsl:param> - <!--################################################### - Misc - ################################################### --> - <!-- Placement of titles --> - <xsl:param name="formal.title.placement"> - figure after - example before - equation before - table before - procedure before - </xsl:param> - <xsl:template match="author" mode="titlepage.mode"> - <xsl:if test="name(preceding-sibling::*[1]) = 'author'"> - <xsl:text>, </xsl:text> - </xsl:if> - <span class="{name(.)}"> - <xsl:call-template name="person.name"/> - <xsl:apply-templates mode="titlepage.mode" select="./contrib"/> - <xsl:apply-templates mode="titlepage.mode" select="./affiliation"/> - </span> - </xsl:template> - <xsl:template match="authorgroup" mode="titlepage.mode"> - <div class="{name(.)}"> - <h2>Authors</h2> - <p/> - <xsl:apply-templates mode="titlepage.mode"/> - </div> - </xsl:template> - <!--################################################### - Headers and Footers - ################################################### --> - <!-- let's have a Spring and SpringSource banner across the top of each page --> - <xsl:template name="user.header.navigation"> - <div style="background-color:white;border:none;height:73px;border:1px solid black;"> - <a style="border:none;" href="http://static.springframework.org/spring-ws/site/" - title="The Spring Framework - Spring Web Services"> - <img style="border:none;" src="images/xdev-spring_logo.jpg"/> - </a> - <a style="border:none;" href="http://www.springsource.com/" title="SpringSource"> - <img style="border:none;position:absolute;padding-top:5px;right:42px;" src="images/s2_box_logo.png"/> - </a> - </div> - </xsl:template> - <!-- no other header navigation (prev, next, etc.) --> - <xsl:template name="header.navigation"/> - <xsl:param name="navig.showtitles">1</xsl:param> - <!-- let's have a 'Sponsored by SpringSource' strapline (or somesuch) across the bottom of each page --> - <xsl:template name="footer.navigation"> - <xsl:param name="prev" select="/foo"/> - <xsl:param name="next" select="/foo"/> - <xsl:param name="nav.context"/> - <xsl:variable name="home" select="/*[1]"/> - <xsl:variable name="up" select="parent::*"/> - <xsl:variable name="row1" select="count($prev) > 0 - or count($up) > 0 - or count($next) > 0"/> - <xsl:variable name="row2" select="($prev and $navig.showtitles != 0) - or (generate-id($home) != generate-id(.) - or $nav.context = 'toc') - or ($chunk.tocs.and.lots != 0 - and $nav.context != 'toc') - or ($next and $navig.showtitles != 0)"/> - <xsl:if test="$suppress.navigation = '0' and $suppress.footer.navigation = '0'"> - <div class="navfooter"> - <xsl:if test="$footer.rule != 0"> - <hr/> - </xsl:if> - <xsl:if test="$row1 or $row2"> - <table width="100%" summary="Navigation footer"> - <xsl:if test="$row1"> - <tr> - <td width="40%" align="left"> - <xsl:if test="count($prev)>0"> - <a accesskey="p"> - <xsl:attribute name="href"> - <xsl:call-template name="href.target"> - <xsl:with-param name="object" select="$prev"/> - </xsl:call-template> - </xsl:attribute> - <xsl:call-template name="navig.content"> - <xsl:with-param name="direction" select="'prev'"/> - </xsl:call-template> - </a> - </xsl:if> - <xsl:text> </xsl:text> - </td> - - <td width="20%" align="center"> - <xsl:choose> - <xsl:when test="$home != . or $nav.context = 'toc'"> - <a accesskey="h"> - <xsl:attribute name="href"> - <xsl:call-template name="href.target"> - <xsl:with-param name="object" select="$home"/> - </xsl:call-template> - </xsl:attribute> - <xsl:call-template name="navig.content"> - <xsl:with-param name="direction" select="'home'"/> - </xsl:call-template> - </a> - <xsl:if test="$chunk.tocs.and.lots != 0 and $nav.context != 'toc'"> - <xsl:text> | </xsl:text> - </xsl:if> - </xsl:when> - <xsl:otherwise> </xsl:otherwise> - </xsl:choose> - <xsl:if test="$chunk.tocs.and.lots != 0 and $nav.context != 'toc'"> - <a accesskey="t"> - <xsl:attribute name="href"> - <xsl:apply-templates select="/*[1]" mode="recursive-chunk-filename"> - <xsl:with-param name="recursive" select="true()"/> - </xsl:apply-templates> - <xsl:text>-toc</xsl:text> - <xsl:value-of select="$html.ext"/> - </xsl:attribute> - <xsl:call-template name="gentext"> - <xsl:with-param name="key" select="'nav-toc'"/> - </xsl:call-template> - </a> - </xsl:if> - </td> - <td width="40%" align="right"> - <xsl:text> </xsl:text> - <xsl:if test="count($next)>0"> - <a accesskey="n"> - <xsl:attribute name="href"> - <xsl:call-template name="href.target"> - <xsl:with-param name="object" select="$next"/> - </xsl:call-template> - </xsl:attribute> - <xsl:call-template name="navig.content"> - <xsl:with-param name="direction" select="'next'"/> - </xsl:call-template> - </a> - </xsl:if> - </td> - </tr> - </xsl:if> - <xsl:if test="$row2"> - <tr> - <td width="40%" align="left" valign="top"> - <xsl:if test="$navig.showtitles != 0"> - <xsl:apply-templates select="$prev" mode="object.title.markup"/> - </xsl:if> - <xsl:text> </xsl:text> - </td> - <td width="20%" align="center"> - <span style="color:white;font-size:90%;"> - <a href="http://www.springsource.com/" - title="SpringSource">Sponsored by SpringSource - </a> - </span> - </td> - <td width="40%" align="right" valign="top"> - <xsl:text> </xsl:text> - <xsl:if test="$navig.showtitles != 0"> - <xsl:apply-templates select="$next" mode="object.title.markup"/> - </xsl:if> - </td> - </tr> - </xsl:if> - </table> - </xsl:if> - </div> - </xsl:if> - </xsl:template> -</xsl:stylesheet> diff --git a/src/docbkx/resources/xsl/pdf/fopdf.xsl b/src/docbkx/resources/xsl/pdf/fopdf.xsl deleted file mode 100644 index 2905ee3c..00000000 --- a/src/docbkx/resources/xsl/pdf/fopdf.xsl +++ /dev/null @@ -1,518 +0,0 @@ -<?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. ---> - -<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" - xmlns:fo="http://www.w3.org/1999/XSL/Format" - xmlns:xslthl="http://xslthl.sf.net" - exclude-result-prefixes="xslthl" - version='1.0'> - -<!-- Use nice graphics for admonitions --> - <xsl:param name="admon.graphics">'1'</xsl:param> - <xsl:param name="admon.graphics.path">@file.prefix@@dbf.xsl@/images/</xsl:param> - <xsl:param name="draft.watermark.image" select="'@file.prefix@@dbf.xsl@/images/draft.png'"/> - <xsl:param name="paper.type" select="'@paper.type@'"/> - - <xsl:param name="page.margin.top" select="'1cm'"/> - <xsl:param name="region.before.extent" select="'1cm'"/> - <xsl:param name="body.margin.top" select="'1.5cm'"/> - - <xsl:param name="body.margin.bottom" select="'1.5cm'"/> - <xsl:param name="region.after.extent" select="'1cm'"/> - <xsl:param name="page.margin.bottom" select="'1cm'"/> - <xsl:param name="title.margin.left" select="'0cm'"/> - -<!--################################################### - Header - ################################################### --> - -<!-- More space in the center header for long text --> - <xsl:attribute-set name="header.content.properties"> - <xsl:attribute name="font-family"> - <xsl:value-of select="$body.font.family"/> - </xsl:attribute> - <xsl:attribute name="margin-left">-5em</xsl:attribute> - <xsl:attribute name="margin-right">-5em</xsl:attribute> - </xsl:attribute-set> - -<!--################################################### - Table of Contents - ################################################### --> - - <xsl:param name="generate.toc"> - book toc,title - </xsl:param> - -<!--################################################### - Custom Header - ################################################### --> - - <xsl:template name="header.content"> - <xsl:param name="pageclass" select="''"/> - <xsl:param name="sequence" select="''"/> - <xsl:param name="position" select="''"/> - <xsl:param name="gentext-key" select="''"/> - - <xsl:variable name="Version"> - <xsl:choose> - <xsl:when test="//productname"> - <xsl:value-of select="//productname"/><xsl:text> </xsl:text> - </xsl:when> - <xsl:otherwise> - <xsl:text>please define productname in your docbook file!</xsl:text> - </xsl:otherwise> - </xsl:choose> - </xsl:variable> - - <xsl:choose> - <xsl:when test="$sequence='blank'"> - <xsl:choose> - <xsl:when test="$position='center'"> - <xsl:value-of select="$Version"/> - </xsl:when> - - <xsl:otherwise> - <!-- nop --> - </xsl:otherwise> - </xsl:choose> - </xsl:when> - - <xsl:when test="$pageclass='titlepage'"> - <!-- nop: other titlepage sequences have no header --> - </xsl:when> - - <xsl:when test="$position='center'"> - <xsl:value-of select="$Version"/> - </xsl:when> - - <xsl:otherwise> - <!-- nop --> - </xsl:otherwise> - </xsl:choose> - </xsl:template> - -<!--################################################### - Custom Footer - ################################################### --> - - <xsl:template name="footer.content"> - <xsl:param name="pageclass" select="''"/> - <xsl:param name="sequence" select="''"/> - <xsl:param name="position" select="''"/> - <xsl:param name="gentext-key" select="''"/> - - <xsl:variable name="Version"> - <xsl:choose> - <xsl:when test="//releaseinfo"> - <xsl:value-of select="//releaseinfo"/> - </xsl:when> - <xsl:otherwise> - <!-- nop --> - </xsl:otherwise> - </xsl:choose> - </xsl:variable> - - <xsl:variable name="Title"> - <xsl:value-of select="//title"/> - </xsl:variable> - - <xsl:choose> - <xsl:when test="$sequence='blank'"> - <xsl:choose> - <xsl:when test="$double.sided != 0 and $position = 'left'"> - <xsl:value-of select="$Version"/> - </xsl:when> - - <xsl:when test="$double.sided = 0 and $position = 'center'"> - <!-- nop --> - </xsl:when> - - <xsl:otherwise> - <fo:page-number/> - </xsl:otherwise> - </xsl:choose> - </xsl:when> - - <xsl:when test="$pageclass='titlepage'"> - <!-- nop: other titlepage sequences have no footer --> - </xsl:when> - - <xsl:when test="$double.sided != 0 and $sequence = 'even' and $position='left'"> - <fo:page-number/> - </xsl:when> - - <xsl:when test="$double.sided != 0 and $sequence = 'odd' and $position='right'"> - <fo:page-number/> - </xsl:when> - - <xsl:when test="$double.sided = 0 and $position='right'"> - <fo:page-number/> - </xsl:when> - - <xsl:when test="$double.sided != 0 and $sequence = 'odd' and $position='left'"> - <xsl:value-of select="$Version"/> - </xsl:when> - - <xsl:when test="$double.sided != 0 and $sequence = 'even' and $position='right'"> - <xsl:value-of select="$Version"/> - </xsl:when> - - <xsl:when test="$double.sided = 0 and $position='left'"> - <xsl:value-of select="$Version"/> - </xsl:when> - - <xsl:when test="$position='center'"> - <xsl:value-of select="$Title"/> - </xsl:when> - - <xsl:otherwise> - <!-- nop --> - </xsl:otherwise> - </xsl:choose> - </xsl:template> - - <xsl:template match="processing-instruction('hard-pagebreak')"> - <fo:block break-before='page'/> - </xsl:template> - -<!--################################################### - Extensions - ################################################### --> - -<!-- These extensions are required for table printing and other stuff --> - <xsl:param name="use.extensions">1</xsl:param> - <xsl:param name="tablecolumns.extension">0</xsl:param> - <xsl:param name="callout.extensions">1</xsl:param> - <xsl:param name="fop.extensions">1</xsl:param> - -<!--################################################### - Paper & Page Size - ################################################### --> - -<!-- Paper type, no headers on blank pages, no double sided printing --> - <xsl:param name="double.sided">0</xsl:param> - <xsl:param name="headers.on.blank.pages">0</xsl:param> - <xsl:param name="footers.on.blank.pages">0</xsl:param> - -<!--################################################### - Fonts & Styles - ################################################### --> - - <xsl:param name="hyphenate">false</xsl:param> - -<!-- Default Font size --> - <xsl:param name="body.font.master">11</xsl:param> - <xsl:param name="body.font.small">8</xsl:param> - -<!-- Line height in body text --> - <xsl:param name="line-height">1.4</xsl:param> - -<!-- Chapter title size --> - <xsl:attribute-set name="chapter.titlepage.recto.style"> - <xsl:attribute name="text-align">left</xsl:attribute> - <xsl:attribute name="font-weight">bold</xsl:attribute> - <xsl:attribute name="font-size"> - <xsl:value-of select="$body.font.master * 1.8"/> - <xsl:text>pt</xsl:text> - </xsl:attribute> - </xsl:attribute-set> - -<!-- Why is the font-size for chapters hardcoded in the XSL FO templates? - Let's remove it, so this sucker can use our attribute-set only... --> - <xsl:template match="title" mode="chapter.titlepage.recto.auto.mode"> - <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" - xsl:use-attribute-sets="chapter.titlepage.recto.style"> - <xsl:call-template name="component.title"> - <xsl:with-param name="node" select="ancestor-or-self::chapter[1]"/> - </xsl:call-template> - </fo:block> - </xsl:template> - -<!-- Sections 1, 2 and 3 titles have a small bump factor and padding --> - <xsl:attribute-set name="section.title.level1.properties"> - <xsl:attribute name="space-before.optimum">0.8em</xsl:attribute> - <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute> - <xsl:attribute name="space-before.maximum">0.8em</xsl:attribute> - <xsl:attribute name="font-size"> - <xsl:value-of select="$body.font.master * 1.5"/> - <xsl:text>pt</xsl:text> - </xsl:attribute> - <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute> - </xsl:attribute-set> - <xsl:attribute-set name="section.title.level2.properties"> - <xsl:attribute name="space-before.optimum">0.6em</xsl:attribute> - <xsl:attribute name="space-before.minimum">0.6em</xsl:attribute> - <xsl:attribute name="space-before.maximum">0.6em</xsl:attribute> - <xsl:attribute name="font-size"> - <xsl:value-of select="$body.font.master * 1.25"/> - <xsl:text>pt</xsl:text> - </xsl:attribute> - <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute> - </xsl:attribute-set> - <xsl:attribute-set name="section.title.level3.properties"> - <xsl:attribute name="space-before.optimum">0.4em</xsl:attribute> - <xsl:attribute name="space-before.minimum">0.4em</xsl:attribute> - <xsl:attribute name="space-before.maximum">0.4em</xsl:attribute> - <xsl:attribute name="font-size"> - <xsl:value-of select="$body.font.master * 1.0"/> - <xsl:text>pt</xsl:text> - </xsl:attribute> - <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute> - </xsl:attribute-set> - <xsl:attribute-set name="section.title.level4.properties"> - <xsl:attribute name="space-before.optimum">0.3em</xsl:attribute> - <xsl:attribute name="space-before.minimum">0.3em</xsl:attribute> - <xsl:attribute name="space-before.maximum">0.3em</xsl:attribute> - <xsl:attribute name="font-size"> - <xsl:value-of select="$body.font.master * 0.9"/> - <xsl:text>pt</xsl:text> - </xsl:attribute> - <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute> - </xsl:attribute-set> - -<!-- Use code syntax highlighting --> - <xsl:param name="highlight.source" select="1"/> - <xsl:param name="highlight.default.language" select="xml" /> - - <xsl:template match='xslthl:keyword'> - <fo:inline font-weight="bold" color="#7F0055"><xsl:apply-templates/></fo:inline> - </xsl:template> - - <xsl:template match='xslthl:comment'> - <fo:inline font-style="italic" color="#3F5F5F"><xsl:apply-templates/></fo:inline> - </xsl:template> - - <xsl:template match='xslthl:oneline-comment'> - <fo:inline font-style="italic" color="#3F5F5F"><xsl:apply-templates/></fo:inline> - </xsl:template> - - <xsl:template match='xslthl:multiline-comment'> - <fo:inline font-style="italic" color="#3F5FBF"><xsl:apply-templates/></fo:inline> - </xsl:template> - - <xsl:template match='xslthl:tag'> - <fo:inline color="#3F7F7F"><xsl:apply-templates/></fo:inline> - </xsl:template> - - <xsl:template match='xslthl:attribute'> - <fo:inline color="#7F007F"><xsl:apply-templates/></fo:inline> - </xsl:template> - - <xsl:template match='xslthl:value'> - <fo:inline color="#2A00FF"><xsl:apply-templates/></fo:inline> - </xsl:template> - - <xsl:template match='xslthl:string'> - <fo:inline color="#2A00FF"><xsl:apply-templates/></fo:inline> - </xsl:template> - -<!--################################################### - Tables - ################################################### --> - - <!-- Some padding inside tables --> - <xsl:attribute-set name="table.cell.padding"> - <xsl:attribute name="padding-left">4pt</xsl:attribute> - <xsl:attribute name="padding-right">4pt</xsl:attribute> - <xsl:attribute name="padding-top">4pt</xsl:attribute> - <xsl:attribute name="padding-bottom">4pt</xsl:attribute> - </xsl:attribute-set> - -<!-- Only hairlines as frame and cell borders in tables --> - <xsl:param name="table.frame.border.thickness">0.1pt</xsl:param> - <xsl:param name="table.cell.border.thickness">0.1pt</xsl:param> - -<!--################################################### - Labels - ################################################### --> - -<!-- Label Chapters and Sections (numbering) --> - <xsl:param name="chapter.autolabel" select="1"/> - <xsl:param name="section.autolabel" select="1"/> - <xsl:param name="section.autolabel.max.depth" select="1"/> - - <xsl:param name="section.label.includes.component.label" select="1"/> - <xsl:param name="table.footnote.number.format" select="'1'"/> - -<!--################################################### - Programlistings - ################################################### --> - -<!-- Verbatim text formatting (programlistings) --> - <xsl:attribute-set name="monospace.verbatim.properties"> - <xsl:attribute name="font-size"> - <xsl:value-of select="$body.font.small * 1.0"/> - <xsl:text>pt</xsl:text> - </xsl:attribute> - </xsl:attribute-set> - - <xsl:attribute-set name="verbatim.properties"> - <xsl:attribute name="space-before.minimum">1em</xsl:attribute> - <xsl:attribute name="space-before.optimum">1em</xsl:attribute> - <xsl:attribute name="space-before.maximum">1em</xsl:attribute> - <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute> - - <xsl:attribute name="border-color">#444444</xsl:attribute> - <xsl:attribute name="border-style">solid</xsl:attribute> - <xsl:attribute name="border-width">0.1pt</xsl:attribute> - <xsl:attribute name="padding-top">0.5em</xsl:attribute> - <xsl:attribute name="padding-left">0.5em</xsl:attribute> - <xsl:attribute name="padding-right">0.5em</xsl:attribute> - <xsl:attribute name="padding-bottom">0.5em</xsl:attribute> - <xsl:attribute name="margin-left">0.5em</xsl:attribute> - <xsl:attribute name="margin-right">0.5em</xsl:attribute> - </xsl:attribute-set> - - <!-- Shade (background) programlistings --> - <xsl:param name="shade.verbatim">1</xsl:param> - <xsl:attribute-set name="shade.verbatim.style"> - <xsl:attribute name="background-color">#F0F0F0</xsl:attribute> - </xsl:attribute-set> - - <xsl:attribute-set name="list.block.spacing"> - <xsl:attribute name="space-before.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-before.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-before.maximum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute> - </xsl:attribute-set> - - <xsl:attribute-set name="example.properties"> - <xsl:attribute name="space-before.minimum">0.5em</xsl:attribute> - <xsl:attribute name="space-before.optimum">0.5em</xsl:attribute> - <xsl:attribute name="space-before.maximum">0.5em</xsl:attribute> - <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute> - <xsl:attribute name="keep-together.within-column">always</xsl:attribute> - </xsl:attribute-set> - -<!--################################################### - Title information for Figures, Examples etc. - ################################################### --> - - <xsl:attribute-set name="formal.title.properties" use-attribute-sets="normal.para.spacing"> - <xsl:attribute name="font-weight">normal</xsl:attribute> - <xsl:attribute name="font-style">italic</xsl:attribute> - <xsl:attribute name="font-size"> - <xsl:value-of select="$body.font.master"/> - <xsl:text>pt</xsl:text> - </xsl:attribute> - <xsl:attribute name="hyphenate">false</xsl:attribute> - <xsl:attribute name="space-before.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-before.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-before.maximum">0.1em</xsl:attribute> - </xsl:attribute-set> - -<!--################################################### - Callouts - ################################################### --> - -<!-- don't use images for callouts --> - <xsl:param name="callout.graphics">0</xsl:param> - <xsl:param name="callout.unicode">1</xsl:param> - -<!-- Place callout marks at this column in annotated areas --> - <xsl:param name="callout.defaultcolumn">90</xsl:param> - -<!--################################################### - Misc - ################################################### --> - -<!-- Placement of titles --> - <xsl:param name="formal.title.placement"> - figure after - example after - equation before - table before - procedure before - </xsl:param> - -<!-- Format Variable Lists as Blocks (prevents horizontal overflow) --> - <xsl:param name="variablelist.as.blocks">1</xsl:param> - - <xsl:param name="body.start.indent">0pt</xsl:param> - -<!-- Show only Sections up to level 3 in the TOCs --> - <xsl:param name="toc.section.depth">3</xsl:param> - -<!-- Remove "Chapter" from the Chapter titles... --> - <xsl:param name="local.l10n.xml" select="document('')"/> - <l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0"> - <l:l10n language="en"> - <l:context name="title-numbered"> - <l:template name="chapter" text="%n. %t"/> - <l:template name="section" text="%n %t"/> - </l:context> - <l:context name="title"> - <l:template name="example" text="Example %n %t"/> - </l:context> - </l:l10n> - </l:i18n> - -<!--################################################### - colored and hyphenated links - ################################################### --> - - <xsl:template match="ulink"> - <fo:basic-link external-destination="{@url}" - xsl:use-attribute-sets="xref.properties" - text-decoration="underline" - color="blue"> - <xsl:choose> - <xsl:when test="count(child::node())=0"> - <xsl:value-of select="@url"/> - </xsl:when> - <xsl:otherwise> - <xsl:apply-templates/> - </xsl:otherwise> - </xsl:choose> - </fo:basic-link> - </xsl:template> - - <xsl:template match="link"> - <fo:basic-link internal-destination="{@linkend}" - xsl:use-attribute-sets="xref.properties" - text-decoration="underline" - color="blue"> - <xsl:choose> - <xsl:when test="count(child::node())=0"> - <xsl:value-of select="@linkend"/> - </xsl:when> - <xsl:otherwise> - <xsl:apply-templates/> - </xsl:otherwise> - </xsl:choose> - </fo:basic-link> - </xsl:template> - -</xsl:stylesheet> \ No newline at end of file diff --git a/src/docbkx/resources/xsl/pdf/titlepage.xml b/src/docbkx/resources/xsl/pdf/titlepage.xml deleted file mode 100644 index dc18e1e0..00000000 --- a/src/docbkx/resources/xsl/pdf/titlepage.xml +++ /dev/null @@ -1,101 +0,0 @@ -<?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. ---> - -<!DOCTYPE t:templates [ -<!ENTITY hsize0 "10pt"> -<!ENTITY hsize1 "12pt"> -<!ENTITY hsize2 "14.4pt"> -<!ENTITY hsize3 "17.28pt"> -<!ENTITY hsize4 "20.736pt"> -<!ENTITY hsize5 "24.8832pt"> -<!ENTITY hsize0space "7.5pt"> <!-- 0.75 * hsize0 --> -<!ENTITY hsize1space "9pt"> <!-- 0.75 * hsize1 --> -<!ENTITY hsize2space "10.8pt"> <!-- 0.75 * hsize2 --> -<!ENTITY hsize3space "12.96pt"> <!-- 0.75 * hsize3 --> -<!ENTITY hsize4space "15.552pt"> <!-- 0.75 * hsize4 --> -<!ENTITY hsize5space "18.6624pt"> <!-- 0.75 * hsize5 --> -]> -<t:templates xmlns:t="http://nwalsh.com/docbook/xsl/template/1.0" - xmlns:param="http://nwalsh.com/docbook/xsl/template/1.0/param" - xmlns:fo="http://www.w3.org/1999/XSL/Format" - xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> - - <t:titlepage t:element="book" t:wrapper="fo:block"> - <t:titlepage-content t:side="recto"> - <title - t:named-template="division.title" - param:node="ancestor-or-self::book[1]" - text-align="center" - font-size="&hsize5;" - space-before="&hsize5space;" - font-weight="bold" - font-family="{$title.fontset}"/> - <subtitle - text-align="center" - font-size="&hsize4;" - space-before="&hsize4space;" - font-family="{$title.fontset}"/> - - <!-- <corpauthor space-before="0.5em" - font-size="&hsize2;"/> - <authorgroup space-before="0.5em" - font-size="&hsize2;"/> - <author space-before="0.5em" - font-size="&hsize2;"/> --> - - <mediaobject space-before="2em" space-after="2em"/> - <releaseinfo space-before="5em" font-size="&hsize2;"/> - <copyright space-before="1.5em" - font-weight="normal" - font-size="8"/> - <legalnotice space-before="5em" - font-weight="normal" - font-style="italic" - font-size="8"/> - <othercredit space-before="2em" - font-weight="normal" - font-size="8"/> - <pubdate space-before="0.5em"/> - <revision space-before="0.5em"/> - <revhistory space-before="0.5em"/> - <abstract space-before="0.5em" - text-align="start" - margin-left="0.5in" - margin-right="0.5in" - font-family="{$body.fontset}"/> - </t:titlepage-content> - - <t:titlepage-content t:side="verso"> - </t:titlepage-content> - - <t:titlepage-separator> - </t:titlepage-separator> - - <t:titlepage-before t:side="recto"> - </t:titlepage-before> - - <t:titlepage-before t:side="verso"> - </t:titlepage-before> -</t:titlepage> - -<!-- ==================================================================== --> - -</t:templates> diff --git a/src/docbkx/sample-apps.xml b/src/docbkx/sample-apps.xml deleted file mode 100644 index 4b462d28..00000000 --- a/src/docbkx/sample-apps.xml +++ /dev/null @@ -1,204 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" -"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"> -<chapter id="sample-apps"> - <title>Sample Applications - -
- Introduction - - The Spring AMQP project includes two sample applications. The first is a simple "Hello World" example that demonstrates both synchronous and asynchronous message reception. It provides an excellent starting point for acquiring an understanding of the essential components. The second sample is based on a stock-trading use case to demonstrate the types of interaction that would be common in real world applications. In this chapter, we will provide a quick walk-through of each sample so that you can focus on the most important components. The samples are available in the distribution, and they are both Maven-based, so you should be able to import them directly into any Maven-aware IDE (such as SpringSource Tool Suite). -
- -
- Hello World - - The Hello World sample demonstrates both synchronous and asynchronous message reception. You can import the 'spring-rabbit-helloworld' sample into the IDE and then follow the discussion below. - -
- Synchronous Example - - Within the 'src/main/java' directory, navigate to the 'org.springframework.amqp.helloworld' package. Open the HelloWorldConfiguration class and notice that it contains the @Configuration annotation at class-level and some @Bean annotations at method-level. This is an example of Spring's Java-based configuration. You can read more about that here. - - You will see that the RabbitConfiguration class extends a framework-provided class called AbstractRabbitConfiguration. That forces it to implement the abstract rabbitTemplate() method while the base class itself then creates an 'amqpAdmin' bean. The "rabbitTemplate" bean in turn depends upon the bean that is created by the connectionFactory() method. There, we are providing the 'username' and 'password' properties as well as the 'hostname' constructor argument to an instance of SingleConnectionFactory. - - - - The base class also provides a mechanism that will recognize any Exchange, Queue, or Binding bean definitions and then declare them on the broker. In fact, the "helloWorldQueue" bean that is generated in HelloWorldConfiguration is an example simply because it is an instance of Queue. - - - - Looking back at the "rabbitTemplate" bean configuration, you will see that it has the helloWorldQueue's name set as its "queue" property (for receiving Messages) and for its "routingKey" property (for sending Messages). - - Now that we've explored the configuration, let's look at the code that actually uses these components. First, open the Producer class from within the same package. It contains a main() method where the Spring ApplicationContext is created. - - - - As you can see in the example above, the AmqpTemplate bean is retrieved and used for sending a Message. Since the client code should rely on interfaces whenever possible, the type is AmqpTemplate rather than RabbitTemplate. Even though the bean created in HelloWorldConfiguration is an instance of RabbitTemplate, relying on the interface means that this code is more portable (the configuration can be changed independently of the code). Since the convertAndSend() method is invoked, the template will be delegating to its MessageConverter instance. In this case, it's using the default SimpleMessageConverter, but a different implementation could be provided to the "rabbitTemplate" bean as defined in HelloWorldConfiguration. - - Now open the Consumer class. It actually shares the same configuration base class which means it will be sharing the "rabbitTemplate" bean. That's why we configured that template with both a "routingKey" (for sending) and "queue" (for receiving). As you saw in , you could instead pass the 'routingKey' argument to the send method and the 'queue' argument to the receive method. The Consumer code is basically a mirror image of the Producer, calling receiveAndConvert() rather than convertAndSend(). - - - - If you run the Producer, and then run the Consumer, you should see the message "Received: Hello World" in the console output. - -
- -
- Asynchronous Example - - Now that we've walked through the synchronous Hello World sample, it's time to move on to a slightly more advanced but significantly more powerful option. With a few modifications, the Hello World sample can provide an example of asynchronous reception, a.k.a. Message-driven POJOs. In fact, there is a sub-package that provides exactly that: org.springframework.amqp.samples.helloworld.async. - - Once again, we will start with the sending side. Open the ProducerConfiguration class and notice that it creates a "connectionFactory" and "rabbitTemplate" bean. This time, since the configuration is dedicated to the message sending side, we don't even need any Queue definitions, and the RabbitTemplate only has the 'routingKey' property set. Recall that messages are sent to an Exchange rather than being sent directly to a Queue. The AMQP default Exchange is a direct Exchange with no name. All Queues are bound to that default Exchange with their name as the routing key. That is why we only need to provide the routing key here. - - - - Since this sample will be demonstrating asynchronous message reception, the producing side is designed to continuously send messages (if it were a message-per-execution model like the synchronous version, it would not be quite so obvious that it is in fact a message-driven consumer). The component responsible for sending messages continuously is defined as an inner class within the ProducerConfiguration. It is configured to execute every 3 seconds. - - - - You don't need to understand all of the details since the real focus should be on the receiving side (which we will cover momentarily). However, if you are not yet familiar with Spring 3.0 task scheduling support, you can learn more here. The short story is that the "postProcessor" bean in the ProducerConfiguration is registering the task with a scheduler. - - Now, let's turn to the receiving side. To emphasize the Message-driven POJO behavior will start with the component that is reacting to the messages. The class is called HelloWorldHandler. - - - - Clearly, that is a POJO. It does not extend any base class, it doesn't implement any interfaces, and it doesn't even contain any imports. It is being "adapted" to the MessageListener interface by the Spring AMQP MessageListenerAdapter. That adapter can then be configured on a SimpleMessageListenerContainer. For this sample, the container is created in the ConsumerConfiguration class. You can see the POJO wrapped in the adapter there. - - - - The SimpleMessageListenerContainer is a Spring lifecycle component and will start automatically by default. If you look in the Consumer class, you will see that its main() method consists of nothing more than a one-line bootstrap to create the ApplicationContext. The Producer's main() method is also a one-line bootstrap, since the component whose method is annotated with @Scheduled will also start executing automatically. You can start the Producer and Consumer in any order, and you should see messages being sent and received every 3 seconds. -
-
- -
- Stock Trading - - The Stock Trading sample demonstrates more advanced messaging scenarios than the Hello World sample. However, the configuration is very similar - just a bit more involved. Since we've walked through the Hello World configuration in detail, here we'll focus on what makes this sample different. There is a server that pushes market data (stock quotes) to a Topic Exchange. Then, clients can subscribe to the market data feed by binding a Queue with a routing pattern (e.g. "app.stock.quotes.nasdaq.*"). The other main feature of this demo is a request-reply "stock trade" interaction that is initiated by the client and handled by the server. That involves a private "replyTo" Queue that is sent by the client within the order request Message itself. - - The Server's core configuration is in the RabbitServerConfiguration class within the org.springframework.amqp.rabbit.stocks.config.server package. It extends the AbstractStockAppRabbitConfiguration. That is where the resources common to the Server and Client(s) are defined, including the market data Topic Exchange (whose name is 'app.stock.marketdata') and the Queue that the Server exposes for stock trades (whose name is 'app.stock.request'). In that common configuration file, you will also see that a JsonMessageConverter is configured on the RabbitTemplate. - - The Server-specific configuration consists of 2 things. First, it configures the market data exchange on the RabbitTemplate so that it does not need to provide that exchange name with every call to send a Message. It does this within an abstract callback method defined in the base configuration class. - - - - Secondly, the stock request queue is declared. It does not require any explicit bindings in this case, because it will be bound to the default no-name exchange with its own name as the routing key. As mentioned earlier, the AMQP specification defines that behavior. - - - - Now that you've seen the configuration of the Server's AMQP resources, navigate to the 'org.springframework.amqp.rabbit.stocks' package under the 'src/test/java' directory. There you will see the actual Server class that provides a main() method. It creates an ApplicationContext based on the 'server-bootstrap.xml' config file. In there you will see the scheduled task that publishes dummy market data. That configuration relies upon Spring 3.0's "task" namespace support. The bootstrap config file also imports a few other files. The most interesting one is 'server-messaging.xml' which is directly under 'src/main/resources'. In there you will see the "messageListenerContainer" bean that is responsible for handling the stock trade requests. Finally have a look at the "serverHandler" bean that is defined in "server-handlers.xml" (also in 'src/main/resources'). That bean is an instance of the ServerHandler class and is a good example of a Message-driven POJO that is also capable of sending reply Messages. Notice that it is not itself coupled to the framework or any of the AMQP concepts. It simply accepts a TradeRequest and returns a TradeResponse. - - - - Now that we've seen the most important configuration and code for the Server, let's turn to the Client. The best starting point is probably RabbitClientConfiguration within the 'org.springframework.amqp.rabbit.stocks.config.client' package. Notice that it declares two queues without providing explicit names. - - - - Those are private queues, and unique names will be generated automatically. The first generated queue is used by the Client to bind to the market data exchange that has been exposed by the Server. Recall that in AMQP, consumers interact with Queues while producers interact with Exchanges. The "binding" of Queues to Exchanges is what instructs the broker to deliver, or route, messages from a given Exchange to a Queue. Since the market data exchange is a Topic Exchange, the binding can be expressed with a routing pattern. The RabbitClientConfiguration declares that with a Binding object, and that object is generated with the BindingBuilder's fluent API. - - - - Notice that the actual value has been externalized in a properties file ("client.properties" under src/main/resources), and that we are using Spring's @Value annotation to inject that value. This is generally a good idea, since otherwise the value would have been hardcoded in a class and unmodifiable without recompilation. In this case, it makes it much easier to run multiple versions of the Client while making changes to the routing pattern used for binding. Let's try that now. - - Start by running org.springframework.amqp.rabbit.stocks.Server and then org.springframework.amqp.rabbit.stocks.Client. You should see dummy quotes for NASDAQ stocks because the current value associated with the 'stocks.quote.pattern' key in client.properties is 'app.stock.quotes.nasdaq.*'. Now, while keeping the existing Server and Client running, change that property value to 'app.stock.quotes.nyse.*' and start a second Client instance. You should see that the first client is still receiving NASDAQ quotes while the second client receives NYSE quotes. You could instead change the pattern to get all stocks or even an individual ticker. - - The final feature we'll explore is the request-reply interaction from the Client's perspective. Recall that we have already seen the ServerHandler that is accepting TradeRequest objects and returning TradeResponse objects. The corresponding code on the Client side is RabbitStockServiceGateway in the 'org.springframework.amqp.rabbit.stocks.gateway' package. It delegates to the RabbitTemplate in order to send Messages. - - - - Notice that prior to sending the message, it sets the "replyTo" address. It's providing the queue that was generated by the "traderJoeQueue" bean definition shown above. Here's the @Bean definition for the StockServiceGateway class itself. - - - - We are planning to provide a 'sendAndReceive' as well as a 'convertSendAndReceive' directly in the AmqpTemplate in the Milestone 2 release of Spring AMQP. At that point, this client-side gateway implementation will be simplified considerably. - - If you are no longer running the Server and Client, start them now. Try sending a request with the format of '100 TCKR'. After a brief artificial delay that simulates "processing" of the request, you should see a confirmation message appear on the Client. - -
- diff --git a/src/docbkx/si-amqp.xml b/src/docbkx/si-amqp.xml deleted file mode 100644 index 116f5da5..00000000 --- a/src/docbkx/si-amqp.xml +++ /dev/null @@ -1,60 +0,0 @@ - - - - Spring Integration AMQP Support - -
- Introduction - - The Spring Integration project - will include AMQP Channel Adapters and Gateways that build upon the Spring AMQP project as soon - as the Spring AMQP project has a GA release. For now, those adapters are under development in the - Spring Integration sandbox. - In Spring Integration, "Channel Adapters" are unidirectional (one-way) whereas "Gateways" are - bidirectional (request-reply). Ultimately, we will be providing an inbound-channel-adapter, - outbound-channel-adapter, inbound-gateway, and outbound-gateway. As of the time of the Spring AMQP 1.0 - Milestone 1 release, the 2 Channel Adapters are available. As mentioned, they are still in the "sandbox" - and as such are subject to change and should not be depended upon in a production environment. That said, - if you check out the project, you should be able to build it with Maven and experiment for yourself. - - When the AMQP adapters are part of an official Spring Integration release, the documentation - will be available as part of the Spring Integration distribution. In the meantime, we will just - provide a quick overview of the current state of that development here. -
- -
- Inbound Channel Adapter - - To receive AMQP Messages from a Queue, configure an <inbound-channel-adapter> - - ]]> -
- -
- Outbound Channel Adapter - - To send AMQP Messages to an Exchange, configure an <outbound-channel-adapter>. - A 'routing-key' may optionally be provided in addition to the exchange name. - - ]]> -
- -
- Inbound Gateway - - Coming Soon -
- -
- Outbound Gateway - - Coming Soon -
- -
diff --git a/src/main/javadoc/doc-files/th-background.png b/src/main/javadoc/doc-files/th-background.png deleted file mode 100644 index 72d65e77..00000000 Binary files a/src/main/javadoc/doc-files/th-background.png and /dev/null differ diff --git a/src/main/javadoc/spring-javadoc.css b/src/main/javadoc/spring-javadoc.css deleted file mode 100644 index c438fafa..00000000 --- a/src/main/javadoc/spring-javadoc.css +++ /dev/null @@ -1,178 +0,0 @@ -/* stylesheet.css 2008/04/22 nicolekonicki */ - -/* - * - * Spring-specific Javadoc style sheet - * - */ - - - -.code -{ - border: 1px solid black; - background-color: #F4F4F4; - padding: 5px; -} - -body -{ - font: 12px Verdana, Arial, Helvetica, "Bitstream Vera Sans", sans-serif; - background-color: #fff; - color: #333; -} - - -/* Link colors */ -a -{ - color:#2c7b14; - text-decoration:none; -} - -a:hover -{ - text-decoration:underline; -} - -/* Headings */ -h1 -{ - font-size:28px; - color:#007c00; -} - -/* Table colors */ - -table -{ - border:none; -} - -td -{ - border:none; - border-bottom:1px dotted #ddd; -} - -th -{ - border:none; -} - -.TableHeadingColor th -{ - background-color: #efffcb; - background-image: url(doc-files/th-background.png); - background-repeat: repeat-x; - color:#fff; - font-size:14px; - height:26px; -} - -.TableSubHeadingColor -{ - background: #f7ffee; - -} -.TableRowColor -{ - background: #fff; -} - -.TableRowColor a -{ - border-bottom:none; - color:#2c7b14; - font-weight:normal; -} - -tr.TableRowColor:hover -{ - background:#eef2e1; -} - - -/* Font used in left-hand frame lists */ -.FrameTitleFont -{ - font-size: 120%; - font-weight:bold; -} - -.FrameTitleFont a -{ - color: #333; -} - -.FrameHeadingFont -{ - font-weight: bold; - font-size:95%; -} - -.FrameItemFont -{ - line-height:130%; - font-size: 95%; -} - -.FrameItemFont a -{ - color:#333; -} - -.FrameItemFont a:hover -{ - color:#249901; - border-bottom:none; - text-decoration:underline; -} - -/* Navigation bar fonts and colors */ -.NavBarCell1 -{ - background-color:#fff; - border:none; -} - -.NavBarCell1Rev -{ - background-color:#e3faa5; - border:1px solid #9ad00c; - padding:0; - margin:0; -} - -.NavBarCell1 a -{ - color:#333; - text-decoration:none; -} - -.NavBarFont1Rev -{ - -} - -.NavBarCell2 -{ - border:none; -} - -.NavBarCell2 a -{ - color:#249901; - font-size:90%; -} - -.NavBarCell3 -{ - border:none; -} - -/* Override sizes in font tags */ -font -{ - font: inherit !important; -} diff --git a/src/main/resources/apache-license.txt b/src/main/resources/apache-license.txt deleted file mode 100644 index 261eeb9e..00000000 --- a/src/main/resources/apache-license.txt +++ /dev/null @@ -1,201 +0,0 @@ - Apache License - Version 2.0, January 2004 - http://www.apache.org/licenses/ - - TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION - - 1. Definitions. - - "License" shall mean the terms and conditions for use, reproduction, - and distribution as defined by Sections 1 through 9 of this document. - - "Licensor" shall mean the copyright owner or entity authorized by - the copyright owner that is granting the License. - - "Legal Entity" shall mean the union of the acting entity and all - other entities that control, are controlled by, or are under common - control with that entity. For the purposes of this definition, - "control" means (i) the power, direct or indirect, to cause the - direction or management of such entity, whether by contract or - otherwise, or (ii) ownership of fifty percent (50%) or more of the - outstanding shares, or (iii) beneficial ownership of such entity. - - "You" (or "Your") shall mean an individual or Legal Entity - exercising permissions granted by this License. - - "Source" form shall mean the preferred form for making modifications, - including but not limited to software source code, documentation - source, and configuration files. - - "Object" form shall mean any form resulting from mechanical - transformation or translation of a Source form, including but - not limited to compiled object code, generated documentation, - and conversions to other media types. - - "Work" shall mean the work of authorship, whether in Source or - Object form, made available under the License, as indicated by a - copyright notice that is included in or attached to the work - (an example is provided in the Appendix below). - - "Derivative Works" shall mean any work, whether in Source or Object - form, that is based on (or derived from) the Work and for which the - editorial revisions, annotations, elaborations, or other modifications - represent, as a whole, an original work of authorship. For the purposes - of this License, Derivative Works shall not include works that remain - separable from, or merely link (or bind by name) to the interfaces of, - the Work and Derivative Works thereof. - - "Contribution" shall mean any work of authorship, including - the original version of the Work and any modifications or additions - to that Work or Derivative Works thereof, that is intentionally - submitted to Licensor for inclusion in the Work by the copyright owner - or by an individual or Legal Entity authorized to submit on behalf of - the copyright owner. For the purposes of this definition, "submitted" - means any form of electronic, verbal, or written communication sent - to the Licensor or its representatives, including but not limited to - communication on electronic mailing lists, source code control systems, - and issue tracking systems that are managed by, or on behalf of, the - Licensor for the purpose of discussing and improving the Work, but - excluding communication that is conspicuously marked or otherwise - designated in writing by the copyright owner as "Not a Contribution." - - "Contributor" shall mean Licensor and any individual or Legal Entity - on behalf of whom a Contribution has been received by Licensor and - subsequently incorporated within the Work. - - 2. Grant of Copyright License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - copyright license to reproduce, prepare Derivative Works of, - publicly display, publicly perform, sublicense, and distribute the - Work and such Derivative Works in Source or Object form. - - 3. Grant of Patent License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - (except as stated in this section) patent license to make, have made, - use, offer to sell, sell, import, and otherwise transfer the Work, - where such license applies only to those patent claims licensable - by such Contributor that are necessarily infringed by their - Contribution(s) alone or by combination of their Contribution(s) - with the Work to which such Contribution(s) was submitted. If You - institute patent litigation against any entity (including a - cross-claim or counterclaim in a lawsuit) alleging that the Work - or a Contribution incorporated within the Work constitutes direct - or contributory patent infringement, then any patent licenses - granted to You under this License for that Work shall terminate - as of the date such litigation is filed. - - 4. Redistribution. You may reproduce and distribute copies of the - Work or Derivative Works thereof in any medium, with or without - modifications, and in Source or Object form, provided that You - meet the following conditions: - - (a) You must give any other recipients of the Work or - Derivative Works a copy of this License; and - - (b) You must cause any modified files to carry prominent notices - stating that You changed the files; and - - (c) You must retain, in the Source form of any Derivative Works - that You distribute, all copyright, patent, trademark, and - attribution notices from the Source form of the Work, - excluding those notices that do not pertain to any part of - the Derivative Works; and - - (d) If the Work includes a "NOTICE" text file as part of its - distribution, then any Derivative Works that You distribute must - include a readable copy of the attribution notices contained - within such NOTICE file, excluding those notices that do not - pertain to any part of the Derivative Works, in at least one - of the following places: within a NOTICE text file distributed - as part of the Derivative Works; within the Source form or - documentation, if provided along with the Derivative Works; or, - within a display generated by the Derivative Works, if and - wherever such third-party notices normally appear. The contents - of the NOTICE file are for informational purposes only and - do not modify the License. You may add Your own attribution - notices within Derivative Works that You distribute, alongside - or as an addendum to the NOTICE text from the Work, provided - that such additional attribution notices cannot be construed - as modifying the License. - - You may add Your own copyright statement to Your modifications and - may provide additional or different license terms and conditions - for use, reproduction, or distribution of Your modifications, or - for any such Derivative Works as a whole, provided Your use, - reproduction, and distribution of the Work otherwise complies with - the conditions stated in this License. - - 5. Submission of Contributions. Unless You explicitly state otherwise, - any Contribution intentionally submitted for inclusion in the Work - by You to the Licensor shall be under the terms and conditions of - this License, without any additional terms or conditions. - Notwithstanding the above, nothing herein shall supersede or modify - the terms of any separate license agreement you may have executed - with Licensor regarding such Contributions. - - 6. Trademarks. This License does not grant permission to use the trade - names, trademarks, service marks, or product names of the Licensor, - except as required for reasonable and customary use in describing the - origin of the Work and reproducing the content of the NOTICE file. - - 7. Disclaimer of Warranty. Unless required by applicable law or - agreed to in writing, Licensor provides the Work (and each - Contributor provides its Contributions) on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or - implied, including, without limitation, any warranties or conditions - of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A - PARTICULAR PURPOSE. You are solely responsible for determining the - appropriateness of using or redistributing the Work and assume any - risks associated with Your exercise of permissions under this License. - - 8. Limitation of Liability. In no event and under no legal theory, - whether in tort (including negligence), contract, or otherwise, - unless required by applicable law (such as deliberate and grossly - negligent acts) or agreed to in writing, shall any Contributor be - liable to You for damages, including any direct, indirect, special, - incidental, or consequential damages of any character arising as a - result of this License or out of the use or inability to use the - Work (including but not limited to damages for loss of goodwill, - work stoppage, computer failure or malfunction, or any and all - other commercial damages or losses), even if such Contributor - has been advised of the possibility of such damages. - - 9. Accepting Warranty or Additional Liability. While redistributing - the Work or Derivative Works thereof, You may choose to offer, - and charge a fee for, acceptance of support, warranty, indemnity, - or other liability obligations and/or rights consistent with this - License. However, in accepting such obligations, You may act only - on Your own behalf and on Your sole responsibility, not on behalf - of any other Contributor, and only if You agree to indemnify, - defend, and hold each Contributor harmless for any liability - incurred by, or claims asserted against, such Contributor by reason - of your accepting any such warranty or additional liability. - - END OF TERMS AND CONDITIONS - - APPENDIX: How to apply the Apache License to your work. - - To apply the Apache License to your work, attach the following - boilerplate notice, with the fields enclosed by brackets "[]" - replaced with your own identifying information. (Don't include - the brackets!) The text should be enclosed in the appropriate - comment syntax for the file format. We also recommend that a - file or class name and description of purpose be included on the - same "printed page" as the copyright notice for easier - identification within third-party archives. - - Copyright [yyyy] [name of copyright owner] - - Licensed 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. diff --git a/src/main/resources/changelog.txt b/src/main/resources/changelog.txt deleted file mode 100644 index aa1898f4..00000000 --- a/src/main/resources/changelog.txt +++ /dev/null @@ -1,11 +0,0 @@ -Spring AMQP 1.0.0 Milestone 1 (July 16, 2010) -============================================= - -New Features - * AMQP domain abstractions (Message, Queue, Exchange, etc.) - * AMQP/Rabbit Configuration base classes - * Rabbit ConnectionFactory - * RabbitTemplate - * SimpleMessageListenerContainer for Rabbit - * Erlang helper library - * Rabbit Broker Administration \ No newline at end of file diff --git a/src/main/resources/epl-license.txt b/src/main/resources/epl-license.txt deleted file mode 100644 index 41808a4f..00000000 --- a/src/main/resources/epl-license.txt +++ /dev/null @@ -1,289 +0,0 @@ -ERLANG PUBLIC LICENSE -Version 1.0 - -1. Definitions. - -1.1. ``Contributor'' means each entity that creates or contributes to -the creation of Modifications. - -1.2. ``Contributor Version'' means the combination of the Original -Code, prior Modifications used by a Contributor, and the Modifications -made by that particular Contributor. - -1.3. ``Covered Code'' means the Original Code or Modifications or the -combination of the Original Code and Modifications, in each case -including portions thereof. - -1.4. ``Electronic Distribution Mechanism'' means a mechanism generally -accepted in the software development community for the electronic -transfer of data. - -1.5. ``Executable'' means Covered Code in any form other than Source -Code. - -1.6. ``Initial Developer'' means the individual or entity identified -as the Initial Developer in the Source Code notice required by Exhibit -A. - -1.7. ``Larger Work'' means a work which combines Covered Code or -portions thereof with code not governed by the terms of this License. - -1.8. ``License'' means this document. - -1.9. ``Modifications'' means any addition to or deletion from the -substance or structure of either the Original Code or any previous -Modifications. When Covered Code is released as a series of files, a -Modification is: - -A. Any addition to or deletion from the contents of a file containing - Original Code or previous Modifications. - -B. Any new file that contains any part of the Original Code or - previous Modifications. - -1.10. ``Original Code'' means Source Code of computer software code -which is described in the Source Code notice required by Exhibit A as -Original Code, and which, at the time of its release under this -License is not already Covered Code governed by this License. - -1.11. ``Source Code'' means the preferred form of the Covered Code for -making modifications to it, including all modules it contains, plus -any associated interface definition files, scripts used to control -compilation and installation of an Executable, or a list of source -code differential comparisons against either the Original Code or -another well known, available Covered Code of the Contributor's -choice. The Source Code can be in a compressed or archival form, -provided the appropriate decompression or de-archiving software is -widely available for no charge. - -1.12. ``You'' means an individual or a legal entity exercising rights -under, and complying with all of the terms of, this License. For legal -entities,``You'' includes any entity which controls, is controlled by, -or is under common control with You. For purposes of this definition, -``control'' means (a) the power, direct or indirect, to cause the -direction or management of such entity, whether by contract or -otherwise, or (b) ownership of fifty percent (50%) or more of the -outstanding shares or beneficial ownership of such entity. - -2. Source Code License. - -2.1. The Initial Developer Grant. -The Initial Developer hereby grants You a world-wide, royalty-free, -non-exclusive license, subject to third party intellectual property -claims: - -(a) to use, reproduce, modify, display, perform, sublicense and - distribute the Original Code (or portions thereof) with or without - Modifications, or as part of a Larger Work; and - -(b) under patents now or hereafter owned or controlled by Initial - Developer, to make, have made, use and sell (``Utilize'') the - Original Code (or portions thereof), but solely to the extent that - any such patent is reasonably necessary to enable You to Utilize - the Original Code (or portions thereof) and not to any greater - extent that may be necessary to Utilize further Modifications or - combinations. - -2.2. Contributor Grant. -Each Contributor hereby grants You a world-wide, royalty-free, -non-exclusive license, subject to third party intellectual property -claims: - -(a) to use, reproduce, modify, display, perform, sublicense and - distribute the Modifications created by such Contributor (or - portions thereof) either on an unmodified basis, with other - Modifications, as Covered Code or as part of a Larger Work; and - -(b) under patents now or hereafter owned or controlled by Contributor, - to Utilize the Contributor Version (or portions thereof), but - solely to the extent that any such patent is reasonably necessary - to enable You to Utilize the Contributor Version (or portions - thereof), and not to any greater extent that may be necessary to - Utilize further Modifications or combinations. - -3. Distribution Obligations. - -3.1. Application of License. -The Modifications which You contribute are governed by the terms of -this License, including without limitation Section 2.2. The Source -Code version of Covered Code may be distributed only under the terms -of this License, and You must include a copy of this License with -every copy of the Source Code You distribute. You may not offer or -impose any terms on any Source Code version that alters or restricts -the applicable version of this License or the recipients' rights -hereunder. However, You may include an additional document offering -the additional rights described in Section 3.5. - -3.2. Availability of Source Code. -Any Modification which You contribute must be made available in Source -Code form under the terms of this License either on the same media as -an Executable version or via an accepted Electronic Distribution -Mechanism to anyone to whom you made an Executable version available; -and if made available via Electronic Distribution Mechanism, must -remain available for at least twelve (12) months after the date it -initially became available, or at least six (6) months after a -subsequent version of that particular Modification has been made -available to such recipients. You are responsible for ensuring that -the Source Code version remains available even if the Electronic -Distribution Mechanism is maintained by a third party. - -3.3. Description of Modifications. -You must cause all Covered Code to which you contribute to contain a -file documenting the changes You made to create that Covered Code and -the date of any change. You must include a prominent statement that -the Modification is derived, directly or indirectly, from Original -Code provided by the Initial Developer and including the name of the -Initial Developer in (a) the Source Code, and (b) in any notice in an -Executable version or related documentation in which You describe the -origin or ownership of the Covered Code. - -3.4. Intellectual Property Matters - -(a) Third Party Claims. - If You have knowledge that a party claims an intellectual property - right in particular functionality or code (or its utilization - under this License), you must include a text file with the source - code distribution titled ``LEGAL'' which describes the claim and - the party making the claim in sufficient detail that a recipient - will know whom to contact. If you obtain such knowledge after You - make Your Modification available as described in Section 3.2, You - shall promptly modify the LEGAL file in all copies You make - available thereafter and shall take other steps (such as notifying - appropriate mailing lists or newsgroups) reasonably calculated to - inform those who received the Covered Code that new knowledge has - been obtained. - -(b) Contributor APIs. - If Your Modification is an application programming interface and - You own or control patents which are reasonably necessary to - implement that API, you must also include this information in the - LEGAL file. - -3.5. Required Notices. -You must duplicate the notice in Exhibit A in each file of the Source -Code, and this License in any documentation for the Source Code, where -You describe recipients' rights relating to Covered Code. If You -created one or more Modification(s), You may add your name as a -Contributor to the notice described in Exhibit A. If it is not -possible to put such notice in a particular Source Code file due to -its structure, then you must include such notice in a location (such -as a relevant directory file) where a user would be likely to look for -such a notice. You may choose to offer, and to charge a fee for, -warranty, support, indemnity or liability obligations to one or more -recipients of Covered Code. However, You may do so only on Your own -behalf, and not on behalf of the Initial Developer or any -Contributor. You must make it absolutely clear than any such warranty, -support, indemnity or liability obligation is offered by You alone, -and You hereby agree to indemnify the Initial Developer and every -Contributor for any liability incurred by the Initial Developer or -such Contributor as a result of warranty, support, indemnity or -liability terms You offer. - -3.6. Distribution of Executable Versions. -You may distribute Covered Code in Executable form only if the -requirements of Section 3.1-3.5 have been met for that Covered Code, -and if You include a notice stating that the Source Code version of -the Covered Code is available under the terms of this License, -including a description of how and where You have fulfilled the -obligations of Section 3.2. The notice must be conspicuously included -in any notice in an Executable version, related documentation or -collateral in which You describe recipients' rights relating to the -Covered Code. You may distribute the Executable version of Covered -Code under a license of Your choice, which may contain terms different -from this License, provided that You are in compliance with the terms -of this License and that the license for the Executable version does -not attempt to limit or alter the recipient's rights in the Source -Code version from the rights set forth in this License. If You -distribute the Executable version under a different license You must -make it absolutely clear that any terms which differ from this License -are offered by You alone, not by the Initial Developer or any -Contributor. You hereby agree to indemnify the Initial Developer and -every Contributor for any liability incurred by the Initial Developer -or such Contributor as a result of any such terms You offer. - -3.7. Larger Works. -You may create a Larger Work by combining Covered Code with other code -not governed by the terms of this License and distribute the Larger -Work as a single product. In such a case, You must make sure the -requirements of this License are fulfilled for the Covered Code. - -4. Inability to Comply Due to Statute or Regulation. -If it is impossible for You to comply with any of the terms of this -License with respect to some or all of the Covered Code due to statute -or regulation then You must: (a) comply with the terms of this License -to the maximum extent possible; and (b) describe the limitations and -the code they affect. Such description must be included in the LEGAL -file described in Section 3.4 and must be included with all -distributions of the Source Code. Except to the extent prohibited by -statute or regulation, such description must be sufficiently detailed -for a recipient of ordinary skill to be able to understand it. - -5. Application of this License. - -This License applies to code to which the Initial Developer has -attached the notice in Exhibit A, and to related Covered Code. - -6. CONNECTION TO MOZILLA PUBLIC LICENSE - -This Erlang License is a derivative work of the Mozilla Public -License, Version 1.0. It contains terms which differ from the Mozilla -Public License, Version 1.0. - -7. DISCLAIMER OF WARRANTY. - -COVERED CODE IS PROVIDED UNDER THIS LICENSE ON AN ``AS IS'' BASIS, -WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, -WITHOUT LIMITATION, WARRANTIES THAT THE COVERED CODE IS FREE OF -DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR -NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF -THE COVERED CODE IS WITH YOU. SHOULD ANY COVERED CODE PROVE DEFECTIVE -IN ANY RESPECT, YOU (NOT THE INITIAL DEVELOPER OR ANY OTHER -CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR -CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART -OF THIS LICENSE. NO USE OF ANY COVERED CODE IS AUTHORIZED HEREUNDER -EXCEPT UNDER THIS DISCLAIMER. - -8. TERMINATION. -This License and the rights granted hereunder will terminate -automatically if You fail to comply with terms herein and fail to cure -such breach within 30 days of becoming aware of the breach. All -sublicenses to the Covered Code which are properly granted shall -survive any termination of this License. Provisions which, by their -nature, must remain in effect beyond the termination of this License -shall survive. - -9. DISCLAIMER OF LIABILITY -Any utilization of Covered Code shall not cause the Initial Developer -or any Contributor to be liable for any damages (neither direct nor -indirect). - -10. MISCELLANEOUS -This License represents the complete agreement concerning the subject -matter hereof. If any provision is held to be unenforceable, such -provision shall be reformed only to the extent necessary to make it -enforceable. This License shall be construed by and in accordance with -the substantive laws of Sweden. Any dispute, controversy or claim -arising out of or relating to this License, or the breach, termination -or invalidity thereof, shall be subject to the exclusive jurisdiction -of Swedish courts, with the Stockholm City Court as the first -instance. - -EXHIBIT A. - -``The contents of this file are subject to the Erlang Public License, -Version 1.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.eddieware.org/EPL - -Software distributed under the License is distributed on an "AS IS" -basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See -the License for the specific language governing rights and limitations -under the License. - -The Original Code is Eddie, November, 1998. - -The Initial Developer of the Original Code is Ericsson Telecom -AB. Portions created by Ericsson are Copyright (C), 1998, Ericsson -Telecom AB. All Rights Reserved. - -Contributor(s): ______________________________________.'' diff --git a/src/main/resources/notice.txt b/src/main/resources/notice.txt deleted file mode 100644 index a0769783..00000000 --- a/src/main/resources/notice.txt +++ /dev/null @@ -1,21 +0,0 @@ - ======================================================================== - == NOTICE file corresponding to section 4 d of the Apache License, == - == Version 2.0, in this case for the Spring Integration distribution. == - ======================================================================== - - This product includes software developed by - the Apache Software Foundation (http://www.apache.org). - - The end-user documentation included with a redistribution, if any, - must include the following acknowledgement: - - "This product includes software developed by the Spring Framework - Project (http://www.springframework.org)." - - Alternatively, this acknowledgement may appear in the software itself, - if and wherever such third-party acknowledgements normally appear. - - The names "Spring", "Spring Framework", and "Spring AMQP" must - not be used to endorse or promote products derived from this software - without prior written permission. For written permission, please contact - enquiries@springsource.com. diff --git a/src/main/resources/readme.txt b/src/main/resources/readme.txt deleted file mode 100644 index aba0fe91..00000000 --- a/src/main/resources/readme.txt +++ /dev/null @@ -1,20 +0,0 @@ -SPRING AMQP INTEGRATION 1.0.0 M1 (July 16 2010) ------------------------------------------------ - -Spring AMQP is released under the terms of the Apache Software License Version 2.0 (see license.txt). - - -DISTRIBUTION CONTENTS: - -The JARs are available in the 'dist' directory, and the source JARs are in the 'src' directory. - -The reference manual and javadoc are located in the 'docs' directory. - -This distribution also includes two sample applications (in the 'samples' directory): helloworld and stocks. -Those samples illustrate the main features of Spring AMQP, and the reference manual provides a detailed walk-through. - - -ADDITIONAL RESOURCES: - -Spring AMQP Homepage: http://www.springsource.org/spring-amqp -Spring AMQP Forum: http://forum.springsource.org/forumdisplay.php?f=74