On Mon, Nov 16, 2015 at 3:16 PM, Lochana Ranaweera <locha...@wso2.com>
wrote:

> 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].
>

As we agreed sometimes back we have to be careful on proper wording with
related to JAX-RS :)

- WSO2 MSS is not a JAX-RS runtime, WSO2 MSS is a Java annotation driven
microservices framework.

- We just use some of the annotations defined in JAX-RS spec plus our own
annotations.

Thanks !

>
> [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>
>
>


-- 
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
_______________________________________________
Architecture mailing list
Architecture@wso2.org
https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture

Reply via email to