OFBiz教程---初学者的开发指南

  OFBizTutorial-ABeginnersDevelopmentGuide OFBiz教程 – 初学者的开发指南 ‐+A+Beginners+Development+Guide  Translated by hongs，contact：[e-mail]  CreatingPracticeApplication(HelloWorld...)Writtenby:PranayPandeywithfeedbackandcontributionsfromChiragManocha,RavindraMandre,RobSchapperSpecialthankstoAnilPatelandMridulPathakforinspiringmetowritethistutorial.这教程面向OFBiz初学者。帮助学习OFBiz应用开发流程基础。创建这个教程背后的目的是让开发者通过最佳实践熟悉代码习惯、控制流或更多。这个练习充当OFBiz的”Helloworld”，和由KernighanandRichie引入的c语言编程的第一个Helloworld一样。重要！这教程打算使用最新的SVN版本。不再适用于4版本。与这个应用开发的同时，你可以看OFBiz的视频，它们在注1:有更多的疑问，你可以参考Example组件。你准能在OFBiz的最新代码的example组件中找到你想要的代码。任意时候想参考例子代码，作为这个应用的开发，这些将给你未来的开发中带来帮助。每一个新功能会第一时间加入到example组件中作为参考。注2：在开始开发这应用前，你一定要阅读下面内容：OFBizContributorsBestPractices（）,CodingConventions（）andBestPracticesGuide （）。.注3：不要从其它组件中拷贝文件，因为修订的版本号也会拷贝。如果需要总是创建一个新文件，然后拷贝这文件的内容。也同时可以注意到无用的代码。注4：搜索任意文档最好的地址是。注5：从右边开始阅读控制台的日志是一个习惯，可以使得排除问题变得容易些，更好地理解系统。创建第一个基本应用，命名为practice第1步：在hot-deploy下创建子目录命名为“practice“。这个目录名要匹配我们要创建的组件名。注：记住所有的定制化开发都仅仅在这完成。第2步：在hot-deploy/practice路径下创建ofbiz-component.xml文件，填入下面的内容。（作为参考你可以检查这个文件在OFBiz任意其它组件中）?xmlversion=1.0encoding=UTF-8?ofbiz-componentname=practicexmlns:xsi=:noNamespaceSchemaLocation==maintype=component/webappname=practicetitle=Practiceserver=default-serverbase-permission=OFBTOOLSlocation=webapp/practicemount-point=/practiceapp-bar-display=false//ofbiz-componentofbiz-component.xml说明:1.这个ofbiz-component.xml文件是负责让OFBiz知道资源的位置，同时让你加入到classpath中.2.这个'resource-loadername'可以是任意字符串。这儿我们设为main.这个'type'告诉OFBiz我们将开始装载一个组件。resource-loadername=maintype=component/3.在webapp标签中,有不同的属性和它们的目的如下：webappname=practicetitle=Practiceserver=default-serverbase-permission=OFBTOOLSlocation=webapp/practicemount-point=/practiceapp-bar-display=false/a)name:-定义我们web应用的名字。b)title:-这个将是应用的标识，会显示在顶端导航栏上。c)server:-这个让OFBiz知道使用哪个serverd)base-permission:-这行要求用户要有OFBTOOLS权限才能使用这个应用。因为'admin'用户有这个权限，所以我们不必创建其它新用户。e)location:-在这个服务器上缺省基准路径的位置。f)mount-point:-这是访问资源的URL，应该是localhost:8080/practiceg)app-bar-display:-这个是让OFBiz知道是否显示在主应用导航条上，这个是公用OFBiz修饰的一部分。创建web应用Step-1:在practice组件中创建一个webapp目录(hot-deploy/practice/webapp).，这个目录包含所有这组件相关的webapp目录。Step-2:在webapp目录下创建一个子目录命名为practice,这个就是我们要开发的webapp名称(hot-deploy/practice/webapp/practice).一个组件可以附加多个web应用。比如在marketing组件中有两个webappsmarketingandsfa。我们创建的webapp将按照J2EE的Web应用标准。Step-3:在你webapp下创建WEB-INF目录(hot-deploy/practice/webapp/practice/WEB-INF)。一个OFBiz的web应用要有两个配置文件：controller.xml和web.xml。这controller.xml告诉OFBiz从访问者来的不同请求做不同的事：做什么动作和渲染什么页面。web.xml告诉OFBiz什么资源(databaseandbusinesslogicaccess)对这个web应用是有效的和如何处理web相关的事，比如welcomepages,redirects,anderrorpages。.Step-4创建一个命名为web.xml(web.xml遵守j2eeweb应用规范).这个文件的内容可以从存在的任意组件中拷贝，比如/framework/example组件.需要改变的重要值是display-name、localDispatcherName和mainDecoratorLocation.context-paramparam-namelocalDispatcherName/param-nameparam-valuepractice/param-valuedescriptionAuniquenameusedtoidentify/recognizethelocaldispatcherfortheServiceEngine/description/context-paramcontext-paramparam-namemainDecoratorLocation/param-nameparam-valuecomponent://practice/widget/CommonScreens.xml/param-valuedescriptionThelocationofthemain-decoratorscreentouseforthiswebapp;referredtoasacontextvariableinscreendefXMLfiles./description/context-param现在设置这个值:component://practice/widget/CommonScreens.xml作为这个位置，你一会就会知道原因。这个位置是用来指出在screens中的主修饰器位置的。象如下：${parameters.mainDecoratorLocation}，通过改变它增加了代码的独立性，当我们需要改变主修饰器的位置。那时我们仅仅需要改为这个位置，将会应用到使用它的所有screen。在screen中这样做的好处是可以从其它组件中重用已存在的screen，但是它用你的修饰器来修饰那个screen，仅仅是在相同模式用在所有地方和在所有组件中来显示mainDecoratorLocation.在这个应用开发的不远将来，当你在你的screen中增加修饰器的时候会集中到这点上。Step-5创建一个命名controller.xml(被ofbizwebapp控制器使用)的文件。这个文件开始是小而简单，但随后我们增加功能而快速增长。现在插入下列代码:?xmlversion=1.0encoding=UTF-8?site-confxmlns:xsi=:noNamespaceSchemaLocation==component://common/webcommon/WEB-INF/common-controller.xml/descriptionPracticeComponentSiteConfigurationFile/descriptionownerCopyright2001-2009TheApacheSoftwareFoundation/ownerhandlername=screentype=viewclass=org.ofbiz.widget.screen.ScreenWidgetViewHandler/!--RequestMappings--request-mapuri=mainsecurityhttps=falseauth=false/responsename=successtype=viewvalue=main//request-map!--endofrequestmappings--!--ViewMappings--view-mapname=maintype=screenpage=component://practice/widget/PracticeScreens.xml#main/!--endofviewmappings--/site-confStep-6:移到上一级，创建一个新的目录，命名为'error'(hot-deploy/practice/webapp/practice/error).Step-6.a:在