Taverna Project Retired

tl;dr: The Taverna code base is no longer maintained and is provided here for archival purposes.

From 2014 till 2020 this code base was maintained by the Apache Incubator project Apache Taverna (incubating) (see web archive and podling status).

In 2020 the Taverna community voted to retire Taverna as a project and withdraw the code base from the Apache Software Foundation.

This code base remains available under the Apache License 2.0 (see License below), but is now simply called Taverna rather than Apache Taverna (incubating).

While the code base is no longer actively maintained, Pull Requests are welcome to the GitHub organization taverna, which may infrequently be considered by remaining volunteer caretakers.

Previous releases

Releases 2015-2018 during incubation at Apache Software Foundation are available from the ASF Download Archive https://archive.apache.org/dist/incubator/taverna/

Releases 2014 from the University of Manchester are on BitBucket https://bitbucket.org/taverna/

Releases 2009-2013 from myGrid are on LaunchPad https://launchpad.net/taverna/

Releases 2003-2009 are on SourceForge https://sourceforge.net/projects/taverna/files/taverna/

Binary JARs for Taverna are available from Maven Central https://repo.maven.apache.org/maven2/org/apache/taverna/ or the myGrid Maven repository https://repository.mygrid.org.uk/

Taverna OSGi plugin system

OSGi-based plugin system, including online updates. Written for Taverna, probably usable for any OSGi-based command line/desktop product.

License

• (c) 2007-2014 University of Manchester
• (c) 2014-2018 Apache Software Foundation

This product includes software developed at The Apache Software Foundation.

Licensed under the Apache License 2.0, see the file LICENSE for details.

The file NOTICE contain any additional attributions and details about embedded third-party libraries and source code.

Contribute

Any contributions received are assumed to be covered by the Apache License 2.0.

Prerequisites

• Java 1.8 or newer (tested with OpenJDK 1.8)
• Apache Maven 3.2.5 or newer (older versions probably also work)

Building

To build, use

mvn clean install

This will build each module and run their tests.

Building on Windows

If you are building on Windows, ensure you unpack this source code to a folder with a short path name lenght, e.g. C:\src - as Windows has a limitation on the total path length which might otherwise prevent this code from building successfully.

Skipping tests

To skip the tests (these can be timeconsuming), use:

mvn clean install -DskipTests

If you are modifying this source code independent of the Taverna project, you may not want to run the Rat Maven plugin that enforces Apache headers in every source file - to disable it, try:

mvn clean install -Drat.skip=true

Modules

The Taverna OSGi modules are split into -api and -impl. -api contain Java interfaces and abstract classes and minimal dependencies, while -impl contain the corresponding implementation(s).

• taverna-app-configuration-api - Taverna Application Configuration API
• taverna-app-configuration-impl - Taverna Application Configuration implementation
• taverna-configuration-api - Taverna Configuration API
• taverna-configuration-impl - Taverna Configuration implementation
• taverna-download-api - Taverna Download API
• taverna-download-impl - Taverna Download implementation
• taverna-maven-plugin - Taverna Maven plugin for packaging and deploying Taverna plugins
• taverna-osgi-schemas - Taverna Taverna's OSGi XML schemas and JAXB bindings
• taverna-plugin-api - Taverna Plugin API
• taverna-plugin-impl - Taverna Plugin implementation
• taverna-update-api - Taverna Update API
• taverna-update-impl - Taverna Update implementation
• taverna-osgi-launcher - Taverna OSGi Framework Launcher
• xml-parser-service - Taverna XML Parser Service for OSGi
• xml-transformer-service - Taverna XML Transformer Service for OSGi

See the taverna-osgi javadoc for details on each OSGi service. In brief:

• The OsgiLauncher starts the OSGi framework and installs the provided OSGi bundles. It is used by the taverna-commandline-launcher main() method.
• The PluginManager service from taverna-plugin-api allow managing of plugins in an OSGi application, including online installation and updates of plugins. Each Plugin provide a collection of OSGi bundles that are activated. The plugins and application profile are described in XML according to the taverna-osgi-schemas.
• The UpdateManager can update the installed plugins by downloading from the configured plugin site URI.
• The taverna-maven-plugin allows creating plugins for the Taverna PluginManager using Apache Maven, including deployment to plugin sites.
• The DownloadManager service from taverna-download-api provide convenience methods for downloading a URI to a Path, including hashsum checking using neighbouring .sha1 or .md5 URIs. Used by PluginManager and UpdateManager.
• The ApplicationConfiguration service provide application installation details like the startup directory and home directory for user configuration. The application should have a conf/taverna.app.properties file in its startup folder, e.g. taverna.app.name=taverna-cl-3.0.0 means ~/.taverna-cl-3.0.0/ will be the application's home directory on Unix.
• The ConfigurationManager service from taverna-configuration-api can configure any Configurable like the HTTPProxyConfiguration and the workbench using preferences stored in the application home directory
• The xml-parser-service and xml-transformer-service re-exposes xalan's and xerces's XML parser and XML transformer implementations within SOGi

Spring services

The OSGi services should be discoverable as Spring services, e.g. by adding to your META-INF/spring/update-context-osgi.xml:

    <beans:beans xmlns="http://www.springframework.org/schema/osgi" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    	xmlns:beans="http://www.springframework.org/schema/beans"
    	xsi:schemaLocation="
           http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
           http://www.springframework.org/schema/osgi http://www.springframework.org/schema/osgi/spring-osgi.xsd">

        <reference id="applicationConfiguration" interface="org.apache.taverna.configuration.app.ApplicationConfiguration" />
        <reference id="proxyConfiguration" interface="org.apache.taverna.configuration.proxy.HttpProxyConfiguration" />
        <reference id="configurationManager" interface="org.apache.taverna.configuration.ConfigurationManager" />
        <reference id="downloadManager" interface="org.apache.taverna.download.DownloadManager" />
        <reference id="pluginManager" interface="org.apache.taverna.plugin.PluginManager" />
        <reference id="updateManager" interface="org.apache.taverna.update.UpdateManager" />
    </beans:beans>

Export restrictions

This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See http://www.wassenaar.org/ for more information.

The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with asymmetric algorithms. The form and manner of this Apache Software Foundation distribution makes it eligible for export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.

The following provides more details on the included cryptographic software:

• taverna-download-impl depend on the Apache HttpComponents Client, which can initiate encrypted https:// connections using Java Secure Socket Extension (JSSE).