############################################################################### # # Copyright (c) 2011 - 2012 Talend Inc. - www.talend.com # All rights reserved. # # This program and the accompanying materials are made available # under the terms of the Apache License v2.0 # which accompanies this distribution, and is available at # http://www.apache.org/licenses/LICENSE-2.0 # ############################################################################### Welcome to Talend ESB! ===================================== Talend ESB bundles Service Factory and Integration Factory, Service Locator, Service Activity Monitoring and demo applications to a stable, production ready distribution based on the industry leading open source frameworks Apache CXF and Apache Camel. It includes Web Service support based on JAX-WS and enables simple and scalable message based systems using well known Enterprise Integration Patterns. The Service Locator maintains a repository of service endpoints which can be used by Service Consumers to support simple failover and load balancing scenarios. Service Activity Monitoring allows to log and monitor service calls. A documented Car Rental demo application illustrates how to use these features. Contents ======== Getting Started Examples OSGi Container Service Locator Service Activity Monitoring Talend Service Factory Talend Integration Factory Getting Started =============== The Getting Started Guide can be found in a separate documentation package in the docs folder. It illustrates all features of Talend ESB using example applications. The examples are documented individually and include instructions for building and running each example with just a few command lines. See below for obtaining the examples. If you need more help try talking to us on our forums: http://talendforge.org/forum You can find more information about Apache CXF at http://cxf.apache.org/ You can find more information about Apache Camel at http://camel.apache.org/ Please submit bug reports using one of the following JIRAs: CXF bug reports: https://issues.apache.org/jira/browse/CXF Camel bug reports: https://issues.apache.org/jira/browse/CAMEL Talend ESB (including Service and Integration Factory) bug reports: http://www.talendforge.org/bugs/ Examples ======== Talend ESB provides several examples in a separate documentation package in the examples folder. The example applications and tutorials demonstrate functionality and advanced features of Talend ESB. The examples demonstrate how to use different functionality including: * Advanced web services with Camel * Security configuration within OSGi * Use of blueprint to define routes * Rent a Car demo * Locator sample * Monitoring sample OSGi Container ============== The container subdirectory contains a preconfigured OSGi container that contains all the required OSGi bundles for the CXF third party dependencies. It also includes Apache Karaf to provide easy administration and configuration. For more information about OSGi and Apache Karaf see http://karaf.apache.org/ . OSGi provides a mature, open standards based, highly modular framework for managing component dependencies, service invocation, and lifecycles. It is the basis for Eclipse and provides a lightweight alternative to more monolithic JEE containers while still retaining the powerful management features necessary for the enterprise. Service Locator =============== The Service Locator in the add-ons directory is a service that provides its consumers with a mechanism to discover service endpoints at run time. The Service Locator consists of two parts: An Endpoint repository and a CXF feature used to configure the use of the Service Locator from both the provider and consumer sides. Like any standard CXF feature, the ServiceLocator Feature is configured separately for the service provider and service consumer. The provider side Locator Feature extension registers and deregisters service endpoints in the endpoint repository when the provider becomes available or unavailable. The consumer side Locator Feature extension transparently retrieves service endpoint addresses from the endpoint repository when a service call to a provider is to be made. Service Activity Monitoring =========================== The Service Activity Monitoring (SAM) in the add-ons directory allows to log / monitor service calls done with the Apache CXF Framework. Typical use cases are usage statistics and fault monitoring. The solution consists of two parts: Agent (sam-agent) and Monitoring Server (sam-server). The Agent creates events out of the requests and replies on service consumer and provider side. The events are first collected locally and then sent to the monitoring server periodically to not disturb the normal message flow. The Monitoring Server receives events from the Agent, optionally filters/handlers events and stores them into a database. Talend Service Factory ====================== Talend Service Factory uses the industry leading open source Apache CXF implementation of JAX-WS to help you service enable your existing applications and interfaces. It also includes value added components such as an OSGi container and several new examples. For more information about Apache CXF see http://cxf.apache.org/ . CXF supports Web Services using SOAP with full WS-*functionality including support for WS-Addressing, WS-Reliable Messaging, and WS-Security over both HTTP and JMS transports. CXF's elegantly simple architecture allows declarative, policy-centric support of these qualities of service through configuration rather than code. It also supports non-SOAP bindings including REST. CXF open standards and portability enable you to deliver interoperability for your applications to maximize the value of your application to your users. The lightweight, modular architecture is based on Spring, so it will work with your application regardless of the platform on which it is running. It will run on stand-alone JVM applications, as part of a servlet container such as Tomcat, within a JEE server, or in an OSGi container such as Equinox. Talend Integration Factory ========================== Talend Integration Factory is a fully supported, stable, production ready distribution based on the industry leading open source integration framework Apache Camel. Apache Camel uses well known Enterprise Integration Patterns to make message based system integration simpler yet powerful and scalable. Talend Integration Factory includes an impressive set of available components for all commonly used protocols like http, https, ftp, xmpp, rss and many more. A large number of data formats like EDI, JSON, CSV, HL7 and languages like JS, Python, Scala, are supported out of the box. Its extensible architecture allows developers to easily add support for proprietary protocols and data formats. It uses a lightweight, component based architecture which allows a great of flexibility in deployment scenarios: as stand-alone JVM applications or embedded in a servlet container such as Tomcat, or within a JEE server, or in an OSGi container such as Equinox.