深入浅出oracle之java cloud service扩展

1、Oracle Cloud最佳技术实践深入浅出 ORACLE CLOUD 之Oracle扩展Java Cloud Service-SaaSAuthor: MSN:Creation Date: Last Updated: Document Ref:Version:黎法良Frank.Li faliang.li May 28, 2015March 7, 2021<Document Reference Number> DRAFT 1AApprovals:<Approver 1> <Approver 2> Copy Number Oracle Cloud最佳技术实践Do

2、c Ref: <Document Reference Number>June 17, 2015Document ControlChange RecordReviewersDistributionNote To Holders:If you receive an electronic copy of this document and print it out, please write your name on the equivalent of the cover page, for document control purposes.If you receive aof thi

3、s document, please write your name on the frontcover, for document control purposes.Document Control 2Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyCopy No.NameLocation1Library MasterProject Library2Project Manager34NamePositionDat

4、eAuthorVersionChange Reference28-May-15Frank.LiDraft 1aNo Previous DocumentOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015ContentsDocument Control21.概述5裁剪云应用/拓展云应用5个性化SaaS Cloud5Oracle Java 云服务6Oracle Database 云服务6Cloud 集成6Java云服务文档7云服务申请8创建Oracle账号8订阅Java云服务8等待激活9获取云服务账号信息

5、10确认云服务已激活12一个完整的JCS-SaaS拓展java EE应用例子15先睹为快：发布一个简单的来访者java EE应用15准备开发环境16开发应用27Java EE应用安全性设置例子49先睹为快：发布一个简单的来访者应用49一个完整的JCS-SaaS拓展ADF应用例子55先睹为快：发布一个简单的来访者ADF应用55准备开发环境55开发应用60..........6.Java云服管理8.6.3.面板85命令行接口89域 SFTP&a

6、mp;服务 SFTP94Java云服务SaaS拓展开发指南97使用步骤97SaaS Extension SDK97准备应用开发97JCS-SaaS拓展发布的应用10..4.Document Control 3Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 1

7、7, 2015消息104发布RESTful Web Services104在JCS-SaaS拓展里设置安全性107搭建本地WebLogic服务器环境111应用移植112弃用策略113不支持的特性和API1...常见问题114开发应用错114发布应用错117运行应用错118Open and Closed Issues for this Deliverable1.8.3.1.Open Issues122Closed Issues122Document Control 4Oracle JavaCloudService-S

8、aaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20151.概述Oracle Cloud提供了Oracle Database Cloud Server和Oracle Java Cloud Server SaaS 拓展，这样我们就可以使用Database云服务和Java云服务，发布客户化的应用。下面是云服务的架构图。1.1.裁剪云

9、应用/拓展云应用1.2.个性化SaaS Cloud概述 5Oracle JavaCloud Service-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20151.3.Oracle Java 云服务Oracle Java Cloud Service，可以理解为一个Weblogic的云服务，对于每一个订阅号分配一个domai

10、n。1.4.Oracle Database 云服务Oracle Database Cloud Service，本质上就是分配给当前订阅者的APEX工作区。1.5.Cloud 集成各种云服务的集成。概述6Oracle JavaCloud Service-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20151.6.Java云服

11、务文档Java Cloud ServiceDeploying an Application to Oracle Java Cloud Service - SaaS Extension概述 7Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20152.云服务申请2.1.创建Orac

12、le账号已经有Oracle账号则不用创建，没有则创建一个Oracle账号。2.2.订阅Java云服务可以订阅试用版，只有1使用期限，加上1月延期，最多就2。云服务申请 8Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015也可以版。2.3.等待激活申请的云服务会处于已初始化状

13、态，一直等待Oracle确认并激活，且状态变为标记失效日期。如果迟迟不能激活，可以通过右上方的message方式寻求Oracle帮忙。云服务申请9Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015激活后直接延长试用期，一旦到期就变为已取消了。2.4.获取云服务账号信息此邮件

14、是登录云服务的用户名和。云服务申请 10Oracle JavaCloud Service-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015云服务申请 11Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A

15、 )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20152.5.确认云服务已激活使用云服务账号、域进行登录。云服务申请 12Oracle JavaCloud Service-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Refer

16、ence Number>June 17, 2015Oracle Database Cloud Service，订阅此服务以后，会给你提供一个APEX的工作区Oracle Java Cloud Service，订阅此服务后，会给你提供一个Web Logic的环境，可用于发布个性化应用。订阅后自带一个welcome-app应用(展示SDK文档, 例子, 博客, 白皮书等)，点击Test Application。点击页面URL。云服务申请 13Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. D

17、RAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015跳转到应用首页。到了这里，恭喜你！你的云服务可以正常使用了。云服务申请 14Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Docu

18、ment Reference Number>June 17, 20153.一个完整的JCS-SaaS拓展java EE应用例子3.1.先睹为快：发布一个简单的来访者java EE应用发布到Java云服务的个性化应用，点击运行，可以新增、更新、删除来访者存在Database云服务visitors表）。（保一个完整的JCS-SaaS拓展java EE应用例子15Oracle JavaCloud Service-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyO

19、racle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20153.2.准备开发环境3.2.1.SaaS Extension SDKSaaS Extension SDK，供集成个性化应用服务实例。解压到本地，如D:Oracleoracle-javacloud-sdkSDK文档： oracle-javacloud-sdkdocindex.htmlSDK例子： oracle-javacloud-sdksamplessamples-index.html3.2.2.并安装Eclipse开发工具Eclipse，Eclipse

20、的OEPE 以上版本，文档说明：一个完整的JCS-SaaS拓展java EE应用例子16Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015在安装Weblogic .0版本是会自带OEPE本人使用带多种插件的MyEclipse。一个完整的JCS

21、-SaaS拓展java EE应用例子17Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015也可以使用NetBeansj 7.4版本开发工具+Oracle Cloud插件。3.2.3.并安装Weblogic文档建议使用一下10.3.6版本，目前Oracle Java Clou

22、d Service - SaaS Extension支持的是Weblogic 10.3.6版本：安装，创建新的Weblogic域。一个完整的JCS-SaaS拓展java EE应用例子18Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015下一步。可以修改域的名称和位置，默认，

23、下一步。一个完整的JCS-SaaS拓展java EE应用例子19Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015输入Weblogic管理员的用户名和。默认，下一步。一个完整的JCS-SaaS拓展java EE应用例子20Oracle JavaCloudService-Sa

24、aS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015勾上管理服务器，下一步。默认，下一步一个完整的JCS-SaaS拓展java EE应用例子21Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company

25、- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015点击创建。点击完成。一个完整的JCS-SaaS拓展java EE应用例子22Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference N

26、umber>June 17, 2015浏览器输入http:ip或hostname:port/console。跳转到Weblogic管理台登录页面。输入weblogic和登录进入首页，到这里Weblogic已经安装。3.2.4.WebLogic新建JNDI数据源新建数据源，用于本地开发环境。一个完整的JCS-SaaS拓展java EE应用例子23Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cl

27、oud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015JDBC数据源自定义，JNDI名称要和Database云服务的JNDI名称javatrialdb一致。驱动程序选择9.0.1版本。一个完整的JCS-SaaS拓展java EE应用例子24Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: &

28、lt;Document Reference Number>June 17, 2015点击下一步。输入数据库连接信息，配置成开发环境数据库。一个完整的JCS-SaaS拓展java EE应用例子25Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015测试确认数据源可以。选择

29、目标服务器为默认。一个完整的JCS-SaaS拓展java EE应用例子26Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20153.2.5.Eclipse配置Weblogic服务器配置Weblogic服务器，可在开发时直接通过运行/调试的方式把应用发布到weblogic进行运行

30、。一个完整的JCS-SaaS拓展java EE应用例子27Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20153.3.开发应用3.3.1.创建应用可参考SDK里的一个简单的应用oracle-javacloud-sdksamplesappsvisitors.war。源代码在or

31、acle-javacloud-sdksamplesdbvisitors目录下。此应用的一些对象介绍：1.使用Eclipse创建一个Web Project。2输入应用的名称visitor。一个完整的JCS-SaaS拓展java EE应用例子28Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June

32、 17, 2015一个完整的JCS-SaaS拓展java EE应用例子29Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20153.3.2.配置weblogic.xml配置visitorsWEB-INFclassesMETA-INFweblogic.xml。1.创建weblog

33、ic.xml2.输入xml的名称weblogic.xml3.Eclipse会对xml进行一些校验，根据报错信息把j2ee改为javaee还是报错。Java6后，J2SE、J2EE和J2ME正式更名，将名称中的2去掉，更名后分别为JavaSE,Java EE和Java ME。一个完整的JCS-SaaS拓展java EE应用例子30Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Do

34、c Ref: <Document Reference Number>June 17, 20154.把xmlns=”这行删除则不报错误。3.3.3.创建数据库1.本地开发环境create table VISITOR ( idNUMBER(19) not null, allcomments VARCHAR2(255), datevisited DATE, nameVARCHAR2(255)2.Database云服务环境使用Oracle Databas Cloud Service提供的APEX工作区，新增visitor表。一个完整的JCS-SaaS拓展java EE应用例子31Oracl

35、e JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20153.3.4.配置persistence.xml配置visitorsWEB-INFclassesMETA-INFpersistence.xml，设置数据库来源jta- data-source为订阅的DB云服务，目标数据库版本Oracle

36、10g。在SSH三大框架里的Hibernate框架常用到，用于数据持久化。JTA（Java Transaction API）1.新建persistence.xml。一个完整的JCS-SaaS拓展java EE应用例子32Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015修改

37、<jta-data-source>的值为订阅的Oracle Database云服务的名称javatrialdb。.新建jsp和servlet1.在新建完WebProject后自动新建index.jsp页面，并在web.xml里配置为首页。修改index.jsp页面，使Start指向main URL路径对应的Servlet。为了让jsp页面美观一点，添加个logo图片，和表单的一些css一个完整的JCS-SaaS拓展java EE应用例子33Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud ser

38、vice扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20152.新建Visitor实体Bean，用于来访者登记信息。一个完整的JCS-SaaS拓展java EE应用例子34Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle

39、 Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20153.新建VisitorServlet。一个完整的JCS-SaaS拓展java EE应用例子35Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20

40、154.新增加visitors访者页面方法read。点击Start连接，请求VisitorServlet，参数为null，则read visitors页面，通过out.println加载页面信息。一个完整的JCS-SaaS拓展java EE应用例子36Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>

41、;June 17, 20155.添加visitors增删查改方法本例中使用JPA(Java Persistence API) 里的EntityManager和JTA (Java Transaction API)里的UserTransaction，SSH框架里的Hibernate常用到，用于数据持久化，简单说就是跟数据库做交互。在visitor页面，点击Add按钮，请求VisitorServlet，参数operation=create。一个完整的JCS-SaaS拓展java EE应用例子37Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之ja

42、va cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20153.3.6.配置web.xml在web.xml里配置Servlet。Servlet名称：VisitorServletServlet class路径：com.vision.cloud.jpa.VisitorServleturl匹配模式：/main一个完整的JCS-SaaS拓展java EE应用例子38Oracle JavaClou

43、dService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20153.3.7.本地运行应用部署visitors应用到Weblogic 6.x。设置运行选项，通过Weblogic 6.x方式运行。都设置好了以后，直接单击这些按钮就可以运行/调试。或者选择某个页面运行/调试。一个完整的JCS-SaaS拓展java EE应用

44、例子39Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015也可以先将应用打包成war后，再在Weblogic Server里部署上去。1.启动Weblogic。2.部署应用。一个完整的JCS-SaaS拓展java EE应用例子40Oracle JavaCloudServic

45、e-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20153.3.8.打包应用war使用Eclipse自动打包功能Export进行打包。选择导出方式为war。选择路径。一个完整的JCS-SaaS拓展java EE应用例子41Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之

46、java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20153.3.9.检查应用war部署到Oracle Java云服务的SaaS应用扩展有一些Java包时不能使用，在部署前需要先使用白工具whitelist.jar测试应用里不使用的包。1.打开cmd命令行窗口，进入sdk lib目录。cd D:Oracleoracle-javacloud-sdklib2.运行一下命令查看white

47、list使用方法。java -jar whitelist.jar -help打包的jar里本身里面中文的输出说明本身已经是乱码。但是可以巧妙的使用英文环境，请参考章节常见问题之在使用SDK命令出现乱码3.运行whitelist检查应用war，注意war不能放在带空格的目录下，不然无法识别。java -jar whitelist.jar -l whitelist.log D:Oracleoracle-javacloud- sdkapp_workspacevisitors.war4.查看whitelist.log日志，没有错误，只有警告，此应用war可以部署。一个完整的JCS-SaaS拓展java

48、 EE应用例子42Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 20153.3.10. 登录Java云服务使用sdk的Whitelist tool检查打开Java台一个完整的JCS-SaaS拓展java EE应用例子43Oracle JavaCloudService-SaaS扩

49、展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015页面布局偏好选项，直接点OK。3.3.11. 发布应用到Java云服务在应用部分，点击Deploy New。选择个性化应用visitors.war，输入发布的应用名称visitors，点击发布。一个完整的JCS-SaaS拓展java EE应用例子44Oracle JavaCloud

50、Service-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015各个操作都会在Jobs，当发布的Job是Complete状态表示已经发布。如果应用在发布或者执行某个操作提示没限，查看本文档问题章节-发布错提 示没限。3.3.12. 运行应用点击右上角的Click to refresh，可以看到visitors应用，状态

51、是status pending，选择visitors应用，点击start。刷新后状态是UP，State是Active表示应用已经发布并运行。3.3.13. 测试应用点击Test Application可以测试应用Service-SaaS一个完整的JCS-SaaS拓展java EE应用例子45Oracle JavaCloud扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference N

52、umber>June 17, 2015点击测试visitors的URL：跳转到应用首页index.jsp。点击Start，跳转到Visitor登记页面(VisitorServlet加载的页面)。一个完整的JCS-SaaS拓展java EE应用例子46Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number&

53、gt;June 17, 2015录入来访者信息，点击Add(调用VisitorServlet)。打开数据库云服务台。查看数据库云服务APEX里的visitor表的数据。一个完整的JCS-SaaS拓展java EE应用例子47Oracle JavaCloudService-SaaS扩展File Ref: 深入浅出oracle之java cloud service扩展(v. DRAFT 1A )Company- For internal use onlyOracle Cloud最佳技术实践Doc Ref: <Document Reference Number>June 17, 2015恭喜你，至此你应该学会如何创建一个JAVA EE的Web Project并且发布到Oracle Java Cloud Service。一个完整的JCS-SaaS拓展java EE应用例子48Oracle JavaCloudService-SaaS扩展File Ref: