 
Use of JCP site is subject to the
JCP Terms of Use and the
Oracle Privacy Policy
 |
|
 JSRs: Java Specification Requests
JSR 370: JavaTM API for RESTful Web Services (JAX-RS 2.1) Specification
JCP version in use: 2.10 Java Specification Participation Agreement version in use: 2.0 Description: This JSR is to develop JAX-RS 2.1, the next release of Java API for RESTful Web Services. Expert Group Transparency: Public Project Page Public Communications Issue Tracking Team
Updates to the Original JSR
2017.02.01: 2.12 Please describe the anticipated schedule for the development of this specification. Q1 2017 Early Draft Pavel Bucek has replaced Marek Potociar as one of the Specification Leads.
Specification Leads: Santiago Pericas-Geertsen, Marek Potociar, Oracle E-Mail Addresses: santiago.pericasgeertsen Telephone Numbers: +1 561 214 4736, +420 221 438 041 Fax Numbers: +1 561 214 4736, - 2015.07.14:The schedule has been updated: Q4 2015 Early Draft Q1 2016 Public Review Q3 2016 Proposed Final Draft H1 2017 Final Release
Original Java Specification Request (JSR)
Identification |
Request |
Contributions |
Additional Information
Section 1. Identification Submitting Member: Oracle Name of Contact Person: Santiago Pericas-Geertsen E-Mail Address: santiago.pericasgeertsen Telephone Number: +1 561 214 4736 Fax Number: +1 561 214 4736 Specification Leads: Santiago Pericas-Geertsen, Marek Potociar, Oracle E-Mail Addresses: santiago.pericasgeertsen Telephone Numbers: +1 561 214 4736, +420 221 438 874 Fax Numbers: +1 561 214 4736, +420 221 438 874 Initial Expert Group Membership: TBD Supporting this JSR: Red Hat Section 2: Request
2.1 Please describe the proposed Specification:Server-Sent Events (SSE) is a new technology defined as part of the HTML5 set of recommendations for a client (e.g., a browser) to automatically get updates from a server via HTTP. It is commonly employed for one-way streaming data transmissions in which a server updates a client periodically or every time an event takes place. JAX-RS 2.0 introduced the notion of asynchronous processing for both the client and the server APIs. However, asynchronous processing alone cannot deliver on all the promises of a modern architecture without the help of non-blocking I/O. If only blocking I/O is available, asynchronous processing simply pushes the problem from one thread to the next --this is akin to borrowing from a person to pay another, the problem is not really solved, only deferred. Thus, support for non-blocking I/O is necessary to achieve high throughput and efficiently manage resources like threads.
In summary, the following is a list of the tasks in scope for JAX-RS 2.1: 2.2 What is the target Java platform? (i.e., desktop, server, personal, embedded, card, etc.)This specification is targeted for Java SE 8 or higher and Java EE 8 or higher platforms. 2.3 The Executive Committees would like to ensure JSR submitters think about how their proposed technology relates to all of the Java platform editions. Please provide details here for which platform editions are being targeted by this JSR, and how this JSR has considered the relationship with the other platform editions.This JSR will be available standalone. It is also targeted for inclusion in the Java EE 8 platform. Additionally, Java EE 7 products will be allowed to implement JAX-RS 2.1. 2.4 What need of the Java community will be addressed by the proposed specification?See 2.1 above. 2.5 Why isn't this need met by existing specifications?See 2.1 above. 2.6 Please give a short description of the underlying technology or technologies:See 2.1 above. 2.7 Is there a proposed package name for the API Specification? (i.e., javapi.something, org.something, etc.)JAX-RS 2.1 will use the same root package name as JAX-RS 2.0, namely javax.ws.rs. 2.8 Does the proposed specification have any dependencies on specific operating systems, CPUs, or I/O devices that you know of?No. 2.9 Are there any security issues that cannot be addressed by the current security model?No. This JSR will leverage existing HTTP security mechanisms, but will also explore ways to enable declarative (i.e. annotation-based) security model for securing RESTful application APIs developed using JAX-RS APIs and programming model in order to better fulfill developer requirements. 2.10 Are there any internationalization or localization issues?This JSR will use the I18N support in Java SE. 2.11 Are there any existing specifications that might be rendered obsolete, deprecated, or in need of revision as a result of this work?No. 2.12 Please describe the anticipated schedule for the development of this specification.
2.13 Please describe the anticipated working model for the Expert Group working on developing this specification.The primary means of communication will be e-mail. We will solicit feedback from the community and leverage the open source development model. 2.14 Provide detailed answers to the transparency checklist, making sure to include URLs as appropriate:JAX-RS 2.1 will follow the same working model as JAX-RS 2.0 (JSR-339). In particular, a project site (https://jax-rs-spec.java.net/) will be used to track all issues and disseminate information on the progress of the JSR.
? Is the schedule for the JSR publicly available, current, and updated regularly?
? Can the public read and/or write to a wiki for the JSR?
? Is there a publicly accessible discussion board for the JSR that you read and respond to regularly?
? Have you spoken at conferences and events about the JSR recently?
? Are you using open-source processes for the development of the RI and/or the TCK?
? What are the Terms of Use required to use the collaboration tools you have prepared to use with the Expert Group, so that prospective EG members can judge whether they are compatible with the JSPA?
? What is the location of your publicly-accessible Issue list? In order to enable EC members to judge whether Issues have been adequately addressed, the list must make a clear distinction between Issues that are still open, Issues that have been deferred, and those that are closed, and must indicate the reason for any change of state.
? What is the mechanism for the public to provide feedback on your JSR?
? Where is the publicly-accessible document archive for your Expert Group?
? Does the Community tab for my JSR have links to and information about all public communication mechanisms and sites for the development of my JSR?
? Do you have a Twitter account or other social networking feed which people can follow for updates on your JSR? ? Which specific areas of feedback should interested community members (such as the Adopt-a-JSR program) provide to improve the JSR (please also post this to your Community tab)? In general, any of the areas listed in Section 2.1. For more information, refer to the Community tab in the JSR page at jcp.org. 2.15 Please describe how the RI and TCK will de delivered, i.e. as part of a profile or platform edition, or stand-alone, or both. Include version information for the profile or platform in your answer.The reference implementation will be made available standalone and also as part of the reference implementation for the Java EE 8 platform. The TCK will be made available standalone and as part of the Java EE CTS. 2.16 Please state the rationale if previous versions are available stand-alone and you are now proposing in 2.13 to only deliver RI and TCK as part of a profile or platform edition (See sections 1.1.5 and 1.1.6 of the JCP 2 document).N/A. 2.17 Please provide a description of the business terms for the Specification, RI and TCK that will apply when this JSR is final.
RI license
TCK license
2.18 Please describe the communications channel you have established for the public to observe Expert Group deliberations, provide feedback, and view archives of all Expert Group communications.The Expert Group will conduct business on a publicly readable alias. The public will have an alias on which to provide feedback and discuss issues related to the JSR. There will also be a publicly accessible JIRA and document archive. (See also 2.19 and 2.20 below.) 2.19 What is the URL of the Issue Tracker that the public can read, and how does the public log issues in the Issue Tracker?https://java.net/jira/browse/JAX_RS_SPEC 2.20 Please provide the location of the publicly accessible document archive you have created for the Expert Group.https://java.net/projects/jax-rs-spec/downloads Section 3: Contributions
3.1 Please list any existing documents, specifications, or implementations that describe the technology. Please include links to the documents if they are publicly available.JAX-RS 2.0 specification (https://jcp.org/en/jsr/detail?id=339). 3.2 Explanation of how these items might be used as a starting point for the work.The JAX-RS 2.0 specification will be the starting point for this work. Section 4: Additional Information (Optional)
4.1 This section contains any additional information that the submitting Member wishes to include in the JSR.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
