[OFBiz]开发 三

1. Debug
不要在Eclipse中使用Ant来启动ofbiz, 因为在Eclipse中无法kill掉Ant的进程，而ofbiz又没有提供stop的方法。（有一个hook shutdown的方法，但是没有作用）

使用startofbiz.bat来启动ofbiz, 打开debug模式，端口5005.
注意：如果需要对org.ofbiz.base.start.Start进行debug的话，需要修改：
-Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005

2.ofbiz-component.xml
总共有60个ofbiz-componnet.xml文件。
E:\eclipse-SDK-3.7.1-win32\ofbiz\apache-ofbiz-10.04\framework\catalina\ofbiz-component.xml
配置的是Tomcat的模块

E:\eclipse-SDK-3.7.1-win32\ofbiz\apache-ofbiz-10.04\applications\content\ofbiz-component.xml
配置的是content web应用程序的模块
它含有webapp节点：

<webapp name="content"
        title="Content"
        server="default-server"
        location="webapp/content"
        base-permission="CONTENTMGR"
        mount-point="/content"/>

3.启动过程：org.ofbiz.base.start.Start

   private void startStartLoaders() {
        // start the loaders
        for (StartupLoader loader: loaders) {
            try {
                loader.start();
            } catch (StartupException e) {
                e.printStackTrace();
                System.exit(99);
            }
        }
        serverStarted = true;
    }

然后，进入org.ofbiz.base.container.ContainerLoader的start()方法中, 启动所有的Container:

    public void start() throws StartupException {
        Debug.logInfo("[Startup] Starting containers...", module);

        // start each container object
        for (Container container: loadedContainers) {
            try {
                container.start();
            } catch (ContainerException e) {
                throw new StartupException("Cannot start() " + container.getClass().getName(), e);
            } catch (java.lang.AbstractMethodError e) {
                throw new StartupException("Cannot start() " + container.getClass().getName(), e);
            }
        }
    }

tomcat, 就是其中的一个作为container启动的模块。

4. 关于ofbiz-component.xml的DTD：
http://ofbiz.apache.org/dtds/ofbiz-component.xsd

<classpath type="jar" location="lib/*"/>   ------------------>classpath相关
<classpath type="jar" location="build/lib/*"/>
<classpath type="dir" location="config"/>
<entity-resource type="model"
reader-name="main" loader="main" location="entitydef/entitymodel.xml"/>

classpath可以支持这两种形式：

<classpath type="jar" location="lib/product.jar"/>
<classpath type="dir" location="classes"/>

5.配置文件读取过程：
1), 先从System.getProperty("ofbiz.system.props")中，找到global的配置文件，加载到System properties中。
2)，通过String cfgFile = Start.getConfigFileName(firstArg);得到类似于：
org/ofbiz/base/start/start.properties
这样的配置文件。

6.classpath的加载:
org.ofbiz.base.start.Start.initClasspath()
org.ofbiz.base.start.Start.loadLibs(String, boolean)
它将把以下路径，添加到classpath中去：
E:\eclipse-SDK-3.7.1-win32\ofbiz\apache-ofbiz-10.04\ofbiz.jar;  ------------>启动类
E:\jdk1.6.0_20\lib\tools.jar;
E:\eclipse-SDK-3.7.1-win32\ofbiz\apache-ofbiz-10.04  ------------>ofbiz HOME

E:/eclipse-SDK-3.7.1-win32/ofbiz/apache-ofbiz-10.04/framework/base/lib
E:/eclipse-SDK-3.7.1-win32/ofbiz/apache-ofbiz-10.04/framework/base/build/lib/ofbiz-base.jar
E:/eclipse-SDK-3.7.1-win32/ofbiz/apache-ofbiz-10.04/framework/base/dtd
E:/eclipse-SDK-3.7.1-win32/ofbiz/apache-ofbiz-10.04/framework/base/config

而:
containerconfig=E:/eclipse-SDK-3.7.1-win32/ofbiz/apache-ofbiz-10.04/framework/base/config/ofbiz-containers.xml

7.Debug信息输出：启动JVM时，加上-DDEBUG=true属性.
if (System.getProperty("DEBUG") != null)

8.启动过程中：

  if (fullInit) {
            // initialize the classpath
            initClasspath();  ---------->重要

            // initialize the log directory
            initLogDirectory();

            // initialize the listener thread
            initListenerThread();

            // initialize the startup loaders
            initStartLoaders(); ---------->重要

            // set the shutdown hook
            if (config.useShutdownHook) {
                setShutdownHook();
            } else {
                System.out.println("Shutdown hook disabled");
            }
        }
    }

start.init(args, true);
start.start();

=============>start.init(args, true);
1. 将执行start.properties里面的ofbiz.start.loader1=org.ofbiz.base.container.ContainerLoader
2. 它的org.ofbiz.base.container.ContainerLoader.load(Config, String[])方法，
将会被执行。
3. 把E:/eclipse-SDK-3.7.1-win32/ofbiz/apache-ofbiz-10.04/framework/base/config/ofbiz-containers.xml作为参数传进来
4. 将会从ofbiz-containers.xml中读取9个containers,其中包括了tomcat的那个：
[
org.ofbiz.base.container.ContainerConfig$Container@185fe0c, org.ofbiz.base.container.ContainerConfig$Container@1e9f5cc, org.ofbiz.base.container.ContainerConfig$Container@1082823, org.ofbiz.base.container.ContainerConfig$Container@831a91, org.ofbiz.base.container.ContainerConfig$Container@1453d72, org.ofbiz.base.container.ContainerConfig$Container@c5186e, org.ofbiz.base.container.ContainerConfig$Container@1c70315, org.ofbiz.base.container.ContainerConfig$Container@9b59a2, org.ofbiz.base.container.ContainerConfig$Container@119db9e
]

10个配置的containers:
component-container
classloader-container
commons-vfs-container
webslinger-container
naming-container
rmi-dispatcher
catalina-container  --------->tomcat
ajp-connector
birt-container
beanshell-container

得到：

<container name="catalina-container" class="org.ofbiz.catalina.container.CatalinaContainer">

这里只是收集作用，把它们(9个containers)
放到org.ofbiz.base.container.ContainerLoader.loadedContainers存起来。

=============>start.start();
1. 将执行start.properties里面的ofbiz.start.loader1=org.ofbiz.base.container.ContainerLoader
2. 它的org.ofbiz.base.container.ContainerLoader.start()方法，
将会被执行。
3.它会把刚才记录的9个containers都进行初始起动的。

9.考察Tomcat的启动过程：

<container name="catalina-container" class="org.ofbiz.catalina.container.CatalinaContainer">

先是初始化：
org.ofbiz.catalina.container.CatalinaContainer.init(String[], String)
------>它是在start.init(args, true);的时候，被带起来执行的。
org.ofbiz.catalina.container.CatalinaContainer.loadComponents() ---->循环
org.ofbiz.catalina.container.CatalinaContainer.createContext(WebappInfo)

然后，才是在start.start();的时候，被启动的：
org.ofbiz.catalina.container.CatalinaContainer.start()

信息：debug在：org.ofbiz.catalina.container.CatalinaContainer.loadComponents()

// load the applications
List<ComponentConfig.WebappInfo> webResourceInfos = ComponentConfig.getAllWebappResourceInfos();

可以得到44个web应用程序。

10.一个很重要的jar包：
E:\eclipse-SDK-3.7.1-win32\ofbiz\apache-ofbiz-10.04\framework\base\build\lib\ofbiz-base.jar

它里面的：org.ofbiz.base.component.ComponentConfig.getAllComponents()
也是一个很重要的方法。

关注一下：componentConfigs.put(componentConfig.getGlobalName(), componentConfig);
是什么时候被调用，被填上值的。

它是在start.init(args, true);的时候，它是配置在ofbiz-containers.xml中的第一个节点：

<!-- load the ofbiz component container (always first) -->
<container name="component-container" class="org.ofbiz.base.container.ComponentContainer"/>

它是作为一个container被启动的，它的作用是负责收集所有的component模块信息。

收集的结果，放在：
org.ofbiz.base.component.ComponentConfig.componentConfigs
protected static Map<String, ComponentConfig> componentConfigs
以备接下来的其它的container(如：tomcat)，初始化webapp时使用。

每一个ofbiz-component.xml对应于下面的这个类：
org.ofbiz.base.component.ComponentConfig.ComponentConfig(String, String)
ofbiz-component.xml里面的节点，都是在这个类的构造方法中被解析的，包括webapp:

        // webapp - webappInfos
        for (Element curElement: UtilXml.childElementList(ofbizComponentElement, "webapp")) {
            WebappInfo webappInfo = new WebappInfo(this, curElement);
            this.webappInfos.add(webappInfo);
        }

        // classpath - classpathInfos
        for (Element curElement: UtilXml.childElementList(ofbizComponentElement, "classpath")) {
            ClasspathInfo classpathInfo = new ClasspathInfo(this, curElement);
            this.classpathInfos.add(classpathInfo);
        }