GlassFish REST Administration Backend at JavaOne India 2012
Upcoming SlideShare
Loading in...5
×
 

GlassFish REST Administration Backend at JavaOne India 2012

on

  • 6,824 views

GlassFish REST Administration Backend at JavaOne India 2012

GlassFish REST Administration Backend at JavaOne India 2012

Statistics

Views

Total Views
6,824
Views on SlideShare
6,599
Embed Views
225

Actions

Likes
0
Downloads
37
Comments
0

12 Embeds 225

http://glassfish.collected.info 159
http://feeds.feedburner.com 24
http://javaconsultant.webs.com 12
http://www.unitask.com 11
http://prsync.com 10
http://www.directrss.co.il 2
http://www.hanrss.com 2
http://ogma.biz 1
http://es.flavors.me 1
http://webcache.googleusercontent.com 1
http://blogs.oracle.com 1
http://feeds.iti.bz 1
More...

Accessibility

Categories

Upload Details

Uploaded via as Adobe PDF

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment

GlassFish REST Administration Backend at JavaOne India 2012 GlassFish REST Administration Backend at JavaOne India 2012 Presentation Transcript

  • 1 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • GlassFish REST Administration Back EndArun Gupta, Java EE & GlassFish Guyblogs.oracle.com/arungupta, @arungupta 2 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • The following is intended to outline our general product direction. It is intended for information purposes only, and may not be incorporated into any contract. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described for Oracle s products remains at the sole discretion of Oracle.3 Copyright © 2012, Oracle and/or its affiliates. All rights reserved. 2011,
  • Program Agenda •  Background –  JAX-RS –  GlassFish •  Implementation details •  Tips and Tricks •  Clients •  Future plans •  Q & A4 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Program Agenda •  Background –  JAX-RS –  GlassFish •  Implementation details •  Tips and Tricks •  Clients •  Future plans •  Q & A5 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Background JAX-RS •  JAX-RS –  Standard annotation-driven API that aims to help developers build RESTful Web services in Java –  JSR 311: JAX-RS 1.x released Nov 2009 •  Jersey –  Reference implementation of JAX-RS –  Ships with GlassFish6 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Background Sample JAX-RS resource 1 @Path("myresource")
 2 @Produces({"application/html, application/xml, application/json"})
 3 public class MyResource {
 4
 5 @GET /* curl -X GET http://example.com/myapp/myresource */
 6 public MyResource getMyResource() { . . . }
 7
 8 @GET @Path("{Name}/") /* curl -X GET http://example.com/myapp/myresource/someChildName */
 9 public ChildResource getMyChildResource(@PathParam("Name") String name) { . . .}
 10
 11 @POST /* curl -X POST -d "attr1=value1:attr2=value2..." http://example.com/myapp/myresource */
 12 public Response creatResource(HashMap<String, String> data) { . . . }
 13
 14 @DELETE /* curl -X DELETE http://.../myapp/myresource */
 15 public Response deleteResource() { . . . }
 16 }
 " "7 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Program Agenda •  Background –  JAX-RS •  GlassFish •  Implementation details •  Tips and Tricks •  Clients •  Future plans •  Q & A8 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Background GlassFish –  Java EE reference implementation –  Highly modular •  Leverages OSGI •  Every container/service is a set of OSGI modules •  Multiple distributions –  Java EE Web Profile –  Java EE Full Profile •  Possible to add modules to existing distribution9 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Background GlassFish Modular Architecture Full Profile Distribution MDB Container JMS Service EJB Container CMP Java Mail ACC Web Profile Distribution EJB Lite Java Transaction Naming Web Container Deployment JDBC Service Container Persistence Service Service GlassFish Nucleus Config CLI Monitoing REST Security Grizzly Framework Framework Framework Backend Service HK2 OSGI Runtime Java SE10 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Background GlassFish Configuration •  domain.xml file –  Persistence storage for configuration –  Dynamic structure and content. •  GlassFish is highly modular •  Defined at run time depending on modules installed11 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Background GlassFish domain.xml snippet 1 <domain log-root="${com.sun.aas.instanceRoot}/logs" ... >
 2 <applications>...</applications>
 3 <resources>
 4 <jdbc-connection-pool datasource-classname="..." res-type="javax.sql.XADataSource" name="__TimerPool"> 
 5 <property name="connectionAttributes" value=";create=true"></property>
 6 ...
 7 </jdbc-connection-pool>
 8 <jdbc-connection-pool datasource-classname="..." res-type="javax.sql.XADataSource" name="MyPool"> 
 9 <property name="MyProperty" value="MyValue"></property>
 10 </jdbc-connection-pool>
 11 ...
 12 <jdbc-resource pool-name="TimerPool" jndi-name="jdbc/__TimerPool" object-type="system-admin"></jdbc-resource>
 13 ...
 14 </resources>
 15 <configs>
 16 <config name="server-config">
 17 <http-service> ... </http-service>
 18 <ejb-container session-store="${com.sun.aas.instanceRoot}/session-store">
 19 <ejb-timer-service>...</ejb-timer-service>
 20 </ejb-container>
 21 ...
 22 </config>
 23 ...
 24 </configs>
 25 ...
 26 </domain>"12 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Program Agenda •  Background –  JAX-RS –  GlassFish •  Implementation details •  Tips and Tricks •  Clients •  Future plans •  Q & A13 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Implementation Details GlassFish Config Beans •  Annotated pojos •  Each module uses config beans to define its configuration14 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Implementation Details Example Config Bean @Configured" public interface JdbcConnectionPool extends ConfigBeanProxy {" @Attribute(key=true) " String getName(); " void setName(String value);" " @Attribute " String getDatasourceClassname();" ..." @Element " List<Property> getProperty();" ..." }"15 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Implementation Details Example Config Bean @Configured" public interface JdbcConnectionPool extends ConfigBeanProxy {" @Attribute(key=true) " String getName(); " @Attribute " String getDatasourceClassname();" ..." @Element " List<Property> getProperty();" ..." }" Corresponding snippet from domain.xml <jdbc-connection-pool name=" ... " datasource-classname=" ... " >" <property name="..." value="..."/ > " <property name="..." value="..."/ > " </jdbc-connection-pool>" "16 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Implementation Details GlassFish Command Line Interface (CLI) •  The gateway to manipulate GlassFish configuration –  Transaction –  Replication •  Examples –  Create a jdbc connection pool $ asadmin create-jdbc-connection-pool 
 --datasourceclassname oracle.jdbc.pool.OracleDataSource 
 --property User=scott:Password=tiger:URL=jdbc:oracle:thin ..." MyOraclePool" –  Delete a jdbc connection pool $ asadmin delete-jdbc-connection-pool MyOraclePool"17 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Implementation Details GlassFish Command Line Interface (CLI) 1 @org.glassfish.api.admin.ExecuteOn(RuntimeType.ALL)
 2 @Service(name="create-jdbc-connection-pool")
 3 ...
 4 public class CreateJdbcConnectionPool implements AdminCommand { 
 5 @Param(name="jdbc_connection_pool_id", alias = "name", primary=true)
 6 String jdbc_connection_pool_id;
 7
 8 @Param(name = "datasourceClassname", optional=true)
 9 String datasourceclassname;
 10
 11 @Param(name="property", optional=true, separator=:)
 12 Properties properties;
 13
 14 public void execute(AdminCommandContext context) {
 15 create_internal_data_structures();
 16 persist_into_configuration();
 17 }
 18 }
 "18 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Implementation Details GlassFish admin REST backend •  Management GlassFish Server Instance –  Access to configuration REST Backend –  GET to access and navigate POST DELETE configuration tree GET GlassFish CLI –  POST/DELETE to mutate configuration Config Beans •  Wraps CLI to mutate configuration objects domain.xml19 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Implementation Details GlassFish admin REST backend •  Monitoring GlassFish Server Instance –  Data available as a tree in REST Backend running GlassFish VM GET –  GET to access and navigate Monitoring Tree the tree20 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Implementation Details GlassFish admin REST backend •  Demo –  Lets see REST backend in action21 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Implementation Details GlassFish Config Bean as REST resource 1 public ListJdbcConnectionPoolResource {
 2
 3 @Contextprotected ResourceContext resourceContext;
 4
 5 @GET 
 6 public Response get() {
 7 return Response.ok().entity(get_list_of_jdbc_resourcecs()).build();
 8 }
 9
 10 @POST
 11 public Response createResource(HashMap<String, String> data) {
 12 RestActionReporter actionReport = ResourceUtil.runCommand(getPostCommand(), data, ...);
 13 return Response.ok(arr).build();
 14 }
 15
 16 @Path("{Name}/") 
 17 public JdbcConnectionPoolResource getJdbcConnectionPoolResource(@PathParam("Name") String id) {
 18 JdbcConnectionPoolResource resource = 
 19 resourceContext.getResource(JdbcConnectionPoolResource.class);
 20 resource.setBeanByKey(entity, id);
 21 return resource;
 22 }
 23 }"22 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Implementation Details GlassFish Config Bean as REST resource 1 public class JDBCConnectionPoolResource {" 2 "" 3 @GET" 4 public Response getEntity() {" 5 return Response.ok(get_content_of_current_config_bean() )" 6 } " 7" 8 @POST" 9 public Response updateEntity(HashMap<String, String> data) {" 10 RestActionReporter ar = Util.applyChanges(data, uriInfo, habitat); // calls asadmin set" 11 return Response.ok(
 12 ResourceUtil.getActionReportResult(ar, successMessage, requestHeaders, uriInfo)).build();" 13 }" 14" 15 @DELETE" 16 public Response delete(HashMap<String, String> data) {" 17 RestActionReporter actionReport = runCommand(getDeleteCommand(), data);" 18 }" 19" 20 }" "23 "Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Implementation Details Code Generation •  Generate REST resources dynamically –  Visit each bean of GlassFish config model to drive generation •  Bytecode –  Uses ASM •  Text – For development time debugging •  Report – Generating usage report –  Abstract out most of the logic in handwritten base class –  REST enable newly added module transparently24 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Implementation Details Bootstrapping •  Initialized lazily –  No startup penalty •  No dependency on servlet container –  Using Grizzly adapter Set<Class> classes = 
 <All ASM generated classes> + <All providers> + <static classes>" ResourceConfig rc = new DefaultResourceConfig(classes); " httpHandler = ContainerFactory.createContainer(HttpHandler.class, rc);"25 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Program Agenda •  Background –  JAX-RS –  GlassFish •  Implementation details •  Tips and Tricks •  Clients •  Future plans •  Q & A26 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Tips And Tricks Enable Efficient Programmatic and Manual Consumption •  GlassFish REST interface is used by –  Users of GlassFish. •  Prefer HTML –  GlassFish Admin GUI and other programmatic consumption •  Prefer JSON/XML •  @Provider for various formats –  ActionReport[Html|Json|Xml]Provider •  com.sun.jersey….ResourceConfig#MediaTypeMapping –  Add mediatype mapping for “.xml” “.json” and “.html” for content negotiation27 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Tips And Tricks Annotate domain model •  Enables modularity –  Associate commands that manipulate a config bean @Configured " @RestRedirects({" @RestRedirect(opType = RestRedirect.OpType.POST, commandName = "create-jdbc-resource")," @RestRedirect(opType = RestRedirect.OpType.DELETE, commandName = "delete-jdbc-resource")" })" "public interface JdbcResource extends ConfigBeanProxy, Resource, .. { . . . }" –  Place a command at certain position in tree @Service(name = "copy-config")" @RestEndpoints({" @RestEndpoint(configBean=Configs.class, opType=OpType.POST, path="copy-config",..)" })" public final class CopyConfigCommand ...{ ... }
 "28 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Tips And Tricks Security •  REST is stateless –  Authentication info travels with every request •  GlassFish Admin GUI console (Client) needs to cache credentials •  Security Risk if it caches userId + passWord •  Authentication tokens –  Self expiring –  Admin GUI requests a token with user supplied id and password –  Subsequent request only need to use the token29 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Tips and Tricks GET insatnce1 GET insatnce2 data data Proxy-ing •  GlassFish Monitoring DAS REST Backend –  Data collected on each GET GET instance of cluster Monitoring Tree •  Proxy instance data through DAS Instance2 –  DAS proxies request to Instance1 REST Backend REST Backend target instance Monitoring Tree –  Provides transparency Monitoring Tree –  Handles security30 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Program Agenda •  Background –  JAX-RS –  GlassFish •  Implementation details •  Tips and Tricks •  Clients •  Future plans •  Q & A31 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Clients Of GlassFish REST backend •  GlassFish Admin GUI console •  GlassFish NetBeans plugin •  GlassFish Eclipse plugin •  GlassFish.next •  LightFish.adambien.com •  End Users –  Browser32 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Program Agenda •  Background –  JAX-RS –  GlassFish •  Implementation details •  Tips and Tricks •  Clients •  Future plans •  Q & A33 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Future Plans •  Provide client side library with various language bindings •  Backend of Console for GlassFish.next •  Leverage planned work in Jersey to define REST resources without generating classes •  Improve HTML interface •  Internal clean up34 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Resources •  GlassFish –  home page - http://glassfish.java.net/ –  REST backend source code - https://svn.java.net/svn/glassfish~svn/trunk/main/nucleus/admin/rest/rest-service/ •  JAX-RS –  JAX-RS 1.x - http://jcp.org/en/jsr/detail?id=311 –  JAX-RS 2.0 - http://jcp.org/en/jsr/detail?id=339 –  Jersey – http://jersey.java.net35 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Q&A36 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • Latin America 2011 December 6–8, 2011 Tokyo 2012 April 4–6, 201237 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.
  • 38 Copyright © 2012, Oracle and/or its affiliates. All rights reserved.