Hi

As you all know, the WSO2 Mircoservices Server (MSS[1]) provides for a
unique JAX-RS run time, supporting only a subset of JAX-RS specification
plus a set of additional features focusing on performance and
lightweightness to run microservices.

I have herewith attached a document that contains a comparison of supported
annotations in MSS JAX-RS run time against the JAX-RS recommended run
time[2].

[1]Product-MSS repository url: https://github.com/wso2/product-mss
[2] JSR-000339 JAX-RS 2.0 Specification download url:
http://download.oracle.com/otndocs/jcp/jaxrs-2_0-fr-eval-spec/

Best Regards,
Lochana

On Mon, Nov 16, 2015 at 11:09 AM, Lochana Ranaweera <locha...@wso2.com>
wrote:

> Hi
>
> I have herewith attached a document that contains a comparison of
> annotation support in WSO2 MSS implementation against JAX-RS recommended
> implementation.
>
> Regards,
> Lochana
>
> On Mon, Nov 16, 2015 at 10:02 AM, Samiyuru Senarathne <samiy...@wso2.com>
> wrote:
>
>>
>>
>> On Thu, Oct 15, 2015 at 2:05 PM, Samiyuru Senarathne <samiy...@wso2.com>
>> wrote:
>>
>>> Hi Sameera,
>>>
>>> Please find the details you requested in the mail "WSO2 MSS JAX-RS
>>> Runtime Design Decisions" in architecture list.
>>>
>>> Best Regards,
>>> Samiyuru
>>>
>>> On Thu, Oct 15, 2015 at 11:16 AM, Sameera Jayasoma <same...@wso2.com>
>>> wrote:
>>>
>>>> +1. Since we are providing a subset of JAX-RC specification, we need to
>>>> be clear on what we support. Otherwise we will get into trouble later. This
>>>> got to be a public doc.
>>>>
>>>> Initially we forked netty-http to process JAX-RC annotations, but later
>>>> decided to completely revamp that implementation. Can you give us a summary
>>>> of the changes we have introduced.
>>>>
>>>> Thanks,
>>>> Sameera.
>>>>
>>>> On Thu, Oct 15, 2015 at 10:39 AM, Samiyuru Senarathne <
>>>> samiy...@wso2.com> wrote:
>>>>
>>>>> Sure, we will.
>>>>>
>>>>> On Thu, Oct 15, 2015 at 10:33 AM, Sagara Gunathunga <sag...@wso2.com>
>>>>> wrote:
>>>>>
>>>>>>
>>>>>> Shall we also create a doc with all JAX-RS annotations, extensions
>>>>>> and mentioning what MSS supported and what not supported ?
>>>>>>
>>>>>> Thanks !
>>>>>>
>>>>>> On Thu, Oct 15, 2015 at 10:30 AM, Samiyuru Senarathne <
>>>>>> samiy...@wso2.com> wrote:
>>>>>>
>>>>>>> Hi,
>>>>>>>
>>>>>>> We have been developing our own JAX-RS runtime for WSO2 Micro
>>>>>>> Services Server (MSS). The purpose of that runtime is not to support the
>>>>>>> full JAX-RS specification but to support a subset of the JAX-RS
>>>>>>> specification plus a set of additional features focusing on performance 
>>>>>>> and
>>>>>>> lightweightness to run microservices.
>>>>>>>
>>>>>>> With latest development work currently the MSS JAX-RS runtime
>>>>>>> supports the following features.
>>>>>>>
>>>>>>>    - The runtime can process annotated POJO JAX-RS resource classes
>>>>>>>    and their annotated methods to create REST service endpoints for 
>>>>>>> valid
>>>>>>>    resource methods.
>>>>>>>    - The runtime supports the following class level annotations.
>>>>>>>       - @Path - Root path for resource methods
>>>>>>>       - @Consumes - Default consume media type(s) for resource
>>>>>>>       methods
>>>>>>>       - @Produces - Default produce media type(s) for resource
>>>>>>>       methods
>>>>>>>    - Supports the following method level annotations.
>>>>>>>       - @Path - Endpoint of the method relative to @Path of the
>>>>>>>       class
>>>>>>>       - @Consumes - Media type(s) that the method can consume
>>>>>>>       - @Produces - Media type(s) that is produced by the method
>>>>>>>       - @GET - HTTP GET method
>>>>>>>       - @PUT - HTTP PUT method
>>>>>>>       - @POST - HTTP POST method
>>>>>>>       - @DELETE - HTTP DELETE method
>>>>>>>    - Supports the following parameter level annotations.
>>>>>>>       - @DefaultValue - Specify a default parameter value
>>>>>>>       - @Context - Inject additional objects. Currently supports
>>>>>>>       injection of io.netty.handler.codec.http.HttpRequest and
>>>>>>>       org.wso2.carbon.mss.HttpResponder
>>>>>>>       - @PathParam - /StockQuote/{*symbol*} to get value of symbol
>>>>>>>       - @QueryParam - /Students?*age=18* to get value of age
>>>>>>>       - @HeaderParam - To read HTTP request header values
>>>>>>>    - Supports returning POJO from resource methods to response by
>>>>>>>    xml or json and getting injected POJO to resource methods for request
>>>>>>>    bodies that are json or xml.
>>>>>>>    - Supports returning *javax.ws.rs.core.Response* objects from
>>>>>>>    resource methods to send HTTP responses in a more customised way.
>>>>>>>
>>>>>>> Product-MSS repository url: https://github.com/wso2/product-mss
>>>>>>>
>>>>>>> Best Regards,
>>>>>>> Samiyuru
>>>>>>> --
>>>>>>> Samiyuru Senarathne
>>>>>>> *Software Engineer*
>>>>>>> Mobile : +94 (0) 71 134 6087
>>>>>>> samiy...@wso2.com
>>>>>>>
>>>>>>
>>>>>>
>>>>>>
>>>>>> --
>>>>>> Sagara Gunathunga
>>>>>>
>>>>>> Architect; WSO2, Inc.;  http://wso2.com
>>>>>> V.P Apache Web Services;    http://ws.apache.org/
>>>>>> Linkedin; http://www.linkedin.com/in/ssagara
>>>>>> Blog ;  http://ssagara.blogspot.com
>>>>>>
>>>>>>
>>>>>
>>>>>
>>>>> --
>>>>> Samiyuru Senarathne
>>>>> *Software Engineer*
>>>>> Mobile : +94 (0) 71 134 6087
>>>>> samiy...@wso2.com
>>>>>
>>>>> _______________________________________________
>>>>> Dev mailing list
>>>>> d...@wso2.org
>>>>> http://wso2.org/cgi-bin/mailman/listinfo/dev
>>>>>
>>>>>
>>>>
>>>>
>>>> --
>>>> Sameera Jayasoma,
>>>> Software Architect,
>>>>
>>>> WSO2, Inc. (http://wso2.com)
>>>> email: same...@wso2.com
>>>> blog: http://blog.sameera.org
>>>> twitter: https://twitter.com/sameerajayasoma
>>>> flickr: http://www.flickr.com/photos/sameera-jayasoma/collections
>>>> Mobile: 0094776364456
>>>>
>>>> Lean . Enterprise . Middleware
>>>>
>>>>
>>>
>>>
>>> --
>>> Samiyuru Senarathne
>>> *Software Engineer*
>>> Mobile : +94 (0) 71 134 6087
>>> samiy...@wso2.com
>>>
>>
>>
>>
>> --
>> Samiyuru Senarathne
>> *Software Engineer*
>> Mobile : +94 (0) 71 134 6087
>> samiy...@wso2.com
>>
>
>
>
> --
> Lochana Ranaweera
> Intern Software Engineer
> WSO2 Inc: http://wso2.com
> Mobile: +94716487055 <http://tel%2B716487055>
>



-- 
Lochana Ranaweera
Intern Software Engineer
WSO2 Inc: http://wso2.com
Blog: https://lochanaranaweera.wordpress.com/
Mobile: +94716487055 <http://tel%2B716487055>

Attachment: Annotation Comparison.ods
Description: application/vnd.oasis.opendocument.spreadsheet

_______________________________________________
Architecture mailing list
Architecture@wso2.org
https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture

Reply via email to