THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
Development strategy to be adopted using patches and extending OOTB component to achieve custom needs is one of the important aspects while working in OFBiz because in some cases we need to implement something or extend something in an existing OFBiz component which is client specific and not generalized enough to put back in OFBiz trunk. So to achieve these we usually follow following strategies for testing and production system:
| Table of Contents |
|---|
Maintaining Patches
This strategy can be adopted in case there are some small changes which have to be addressed, this can be either an extension in code for a service or enhancement in a form code or removal of some code etc. This strategy is also helpful and usually adopted for configuration settings like if you want to enable email settings in general.properties or if you want to change a field sql-type for a specific database in fieldtype*.xml.
...
- After making changes in any file either you can create a patch from eclipse or from console.
- For creating a patch from eclipse you just need right click on a file if its a single file or on the root directory if multiple files are there then go to Team --> Create Patch. The patch created by this method needs a little extra concentration as you have to make sure the path to files in your patch is from ofbiz root dir and not the absolute path of your file system, otherwise it will not get applied from root directory, also you need to make sure eclipse properties are not there on the top of the patch, if its there needs to be removed.
- Keep the patch file extension .patch. You can also refer to link
For creating a patch from console use following command on the root directory of files where the changes are:
Code Block svn diff > [file system path for patch file to be created with .patch extension]
...
- In hot-deploy component directory patches should be maintained in proper order.
- Create a patches dir at hot-deploy/customcomponent/patches and put all the patches here which are needed(common) in testing(staging) and production system.
- Create a staging dir at hot-deploy/customcomponent/patches/staging and put all patches here which are needed in testing(staging) instance.
Create a production dir at hot-deploy/customcomponent/patches/production and put all patches here which are needed in production system only.
Note There are certain patches those you will only need to apply on staging box or only need to apply in production thats why we need to have different directories managed like above to differentiate properly and to avoid any confusion, when it comes to take system from testing to production environment. eg. two different baseUrl should be needed in content.properties file for these two different instances.
...
- Applying a patch is again a thing can be done from eclipse or from console.
- Always apply a patch from OFBiz root directory.
- In eclipse click on OFBiz root directory and got to Team --> Apply Patch, just browse the path to patch file and follow the instructions.
- If the changes are in the patch are already there in files being patched then it will show you conflicts in the file which should be resolved before applying the patch.
For applying a patch from console use following command from OFBiz root directory:
Code Block patch -p0 < [patch file path]- While applying the patch if there is a conflict then system will prompt you to either postpond or continue patching, follow the instructions.
- Once the patch is applied you don't need to apply it again until you replace the patched file from source repository or there are conflicts. In case of conflicts you need to update the patch file and apply it again.
Extending an Existing Component
...
- Create custom component in hot-deploy directory by any name as you want to override, its just going be replica of existing OOTB OFBiz component with all the major directories and files required for setting up a component.
- You can use ant create-component target on OFBiz root directory to create this component in hot-deploy directory.
- Only those files need to be added which you need to have in overriding the component, webapp. Rest of the resources are going to be used from OOTB component so if you have used ant create-component target then you can safely delete some of the files like if you are not going to write a service then services.xml file can be deleted, or if you are not going to add or extend an existing entity then you can delete entitymodel.xml file and their entries from ofbiz-component.xml file of custom component.
- Basically this is the thin line between extending a webapp and a component. If you are going to have major changes in services and entities then creating a new component should be preferred where you will be extending the existing webapp.
- e.g. If you want to have a separate component for adding or extending existing functionalities from catalog application which is a webapp in product component then you can have component in hot-deploy dir by extending the catalog webapp from product component.
- Follow below given points:
Make sure to properly override the webapp in ofbiz-component file of custom component as example given below:
Code Block <webapp name="catalog" title="Catalog" server="default-server" location="webapp/catalog" base-permission="OFBTOOLS,CATALOG" mount-point="/catalog" app-bar-display="true"/>Make sure to make entries of custom service defs(if-any), entity defs(if-any) and data files(if-any) in ofbiz-component file of custom component as example given below:
Code Block <entity-resource type="model" reader-name="main" loader="main" location="entitydef/entitymodel.xml"/> <entity-resource type="data" reader-name="seed" loader="main" location="data/*TypeData.xml"/> <service-resource type="model" loader="main" location="servicedef/services.xml"/>- Make sure to have same web.xml file from existing webapp.
- You can have new main-decorator defined for screens in webapp so if this is the case this needs to be changed in web.xml.
Make sure to have controller.xml file in new webapp created and include the the controller from existing webapp and only include custom requests only rest will be taken care by included controller only, as shown bellow:
Code Block <include location="component://product/webapp/catalog/WEB-INF/controller.xml"/>- Make sure to have error.jsp inside extended webapp.
- Make sure to have index.jsp file with redirect path.
...
Use "ant -p" in one of your components created with create-component to know more about them...
I will soon add a complement here (jleroux)
Extending an Existing webapp Only
...
- Follow below given points:
- Add webapp which you want to override from existing OOTB OFBiz component with the one that you already have in your webapp dir.
Make sure to properly override the webapp in ofbiz-component.xml file of custom component with the webapp that you already have as example given below:
Code Block <webapp name="catalog" title="Catalog" server="default-server" location="webapp/catalog" base-permission="OFBTOOLS,CATALOG" mount-point="/catalog" app-bar-display="true"/>- Make sure to have same web.xml file from existing webapp.
- You can have new main-decorator defined for screens in webapp so if this is the case this needs to be changed in web.xml.
Make sure to have controller.xml file in new webapp created and include the the controller from existing webapp and only include custom requests only rest will be taken care by included controller only, as shown bellow:
Code Block <include location="component://product/webapp/catalog/WEB-INF/controller.xml"/>- Make sure to have error.jsp inside extended webapp.
- Make sure to have index.jsp file with redirect path.
- Here for other resources which you would like to add or extend like servicedefs, entitydefs or data files you can use the custom component's directories to add them. Make sure to do entries of these resources in ofbiz-component.xml file of your component to load them.