Page History

...

Apache Project Name : Tuscany 

Mentor Name : Luciano Resende (Pending Confirmation) Resende 

Link To Project Idea JIRA : Enhance Tuscany Widget Support

Proposal Content Details :Current Intentions

1. Abstract

Apache Tuscany is provides efficient solutins for SOA implementation and it works fundamentally based on SCA standards. It provides integration across a wide variety programming platforms available today such as C++, Java, BPEL and more. As a part of it’s multiple platform support, Apache Tuscany is also integrated with web 2.0 technologies. Pojo is the only javascript framework supported by Tuscany right now.

The objective of this proposal is to generically implement a configuration option from where the user can specify the javascript framework he like to use. And as a starting step, integrate today’s most popular javascript framework i.e. jQuery, with Apache Tuscany. Once the option is in place future contributors can include more js frameworks to Apache.

2. Detailed Description

2.1 Modify and Reuse Existing Javascript Configuration Management

As of now Tuscany is configured to use Pojo as it's default framework. The previous contiributors have left out sufficient options to integrate a javascript framework in future. So currently those options are configured to use pojo in Java classes and other file inside the framework and is not exposed to the users to change that from outside.

...

class WidgetImplementationProvider implements ImplementationProvider {
    private static final QName BINDING_HTTP = new QName(Base.SCA11_TUSCANY_NS, "binding.http");
    ...
      public void start() {
        String baseURI = getBaseURI();

        // this uses removeServletMapping / addServletMapping as there is no getServletMapping facility
        scriptURI = URI.create(baseURI + "/" + this.widgetName + ".js").toString();
        Servlet servlet = servletHost.getServletMapping(scriptURI);
        if (servlet == null /*|| servlet instanceof HTTPGetListenerServlet*/) {
            WidgetComponentScriptServlet widgetScriptServlet;
            widgetScriptServlet = new WidgetComponentScriptServlet(this.component, javaScriptGenerator);
            servletHost.addServletMapping(scriptURI, widgetScriptServlet);
        }     

        // If added to the class path, start dojo provider
        if(javascriptProvider != null) {
            javascriptProvider.start();
        }
        
    }
    ...
}

2.2 Implement jQuery Javascript Generator

For every pojo framework supported application there is an automatic javascript file generated that acts as a bridge between the tuscany specific javascript syntax and its counterpart in pojo framework. This javascript is generated by the following file.

...

After evaluating few samples the most suitable calls would be used that suits the Tuscany architecture and modularity.

2.3 Deliverables

jQuery Javascript Generator and related files
The jQuery javascript generator files will generate all the essential files that are required to provide jQuery support for the applicaiton.

...

Documentation
User and developer documentation on Apache Tuscany web page about the new jQuery support.

2.3 Architectural outline

• *User Configuration Option :* User configures the application to use a specific javascript framework supported by jQuery.
• JavaScript Support File Generation : After looking up the configuration the respective javascript code generator will be invoked.
• Application access services via JavaScript : The running application will have the javascript support files generated automatically and the tuscany framework will handle all the necessary jsonrpc service calls made by the user.

3. Timeline