Getting Started with Induction-翻译(2)

littleQ — Thu, 31 Jul 2008 14:17:00 GMT

Deploying the application

在我们运行Controller之前，必须对其进行编译。我们可以使用javac或者任何IDE去编译Controller。接下来，我们要让Tomcat知道我们的web应用程序。我们需要创建一个war包，然后部署到Tomcat中，这步只需要将war包拷贝到:/dev/Tomcat6/webapps目录下。

我们的.war文件中的/WEB-INF文件夹包含以下文件:

web.xml
induction-demoapp.xml

以下.jar文件在WEB-INF/lib中:

acciente-induction-1.x.xb.jar
acciente-commons-1.x.xb.jar

最后,以下工具jar包也同样在WEB-INF/lib中:

apache-bcel-5.2.jar
apache-commons-collections-3.2.1.jar
apache-commons-digester-1.8.jar
apache-commons-fileupload-1.2.1.jar
apache-commons-io-1.4.jar
apache-commons-logging-1.1.1.jar
apache-freemarker-2.3.12.jar

这些.jar文件分别来自于这些工程:Apache Commons库和Apache BCEL库来自Apache Software Foundation. Freemarker库源自Visigoth Software Society.

我们主意到应用程序类的代码(在这里,就是单个Controller类)没有存储在.war文件中,相反,我们会在应用程序的配置文件induction-demoapp.xml中指明编译后.class文件的位置.不管我们什么时候重新编译一个应用程序类,下一次访问这个类的时候,Induction会检测出class文件发生了变化,然后"热部署"到JVM中.因此,当我们修改或者编译应用程序类的时候,没有必要去重新创建或者重新部署war包.

Induction同样也支持将应用程序类放到.war的/WEB-INF/classes下,或者将.jar放到/WEB-INF/lib下,或者Tomcat可以找到的classpath下的其他任何位置.不过在开发中,我们推荐将应用程序类放在war包外面,这样可以通过class的"热重载"来提高生产率.如果有必要的话，应用程序类可以重新打包成.war文件用于传递.接下来,我们来看看war包里面的内容.

首先来看看web.xml.我们在web.xml中所需要做的就是定义Induction的dispatcher servlet去处理对应用程序的请求.

           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
          http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
           version="2.5">
   DemoApp


       demoapp
       com.acciente.induction.dispatcher.HttpDispatcher
       1



       demoapp
       /*

我们再来看看induction-demoapp.xml的内容.假设我们编译后的应用程序类是放在c:/project/demoapp/classes目录下,induction-demoapp.xml的内容就是:

c:/project/demoapp/classes

创建好上面所描述的war包后,部署到Tomcat中.现在,我们可以开始运行我们的应用程序了.

Running the application

假设Tomcat运行在localhost:8080,war包的名字是induction-demo.war,在浏览器中输入以下URL:

http://localhost:8080/induction-demo/demoapp/helloworld1_app/HelloWorldController/

你会在浏览器输出界面看到字符串:

Hello World, using a simple println()

Controlling the URL resolution

现在我们来进一步的看下用来运行Controller的URL:http://localhost:8080/induction-demo/demoapp/helloworld1_app/HelloWorldController/.第一部分http://localhost:8080/induction-demo通过Tomcat指向dispatcher servlet,也就是说这一部分是与Induction无关的.通过Induction处理的URL部分是/demoapp/helloworld1_app/HelloWorldController/.

Induction把URL分解成完整的Controller类和方法名.把URL转换成Controller的类名和方法名,是通过Induction的ControllerResolver类口完成的.当开发者没有指定一个定制的Controller resolver时,Induction会默认使用一个相当简单的controller resolver.默认的controller resolver是这么工作的:分析路径/demoapp/helloworld1_app/HelloWorldController/,把第一个'/'到最后一个'/'之间的内容作为完整的类名(/demoapp/helloworld1_app/HelloWorldController/就是对应到demoapp.helloworld1_app.HelloWorldController).最后一个'/'后所有的内容作为方法名.在我们的例子中,最后一个'/'后没有任何字符串,因此默认的resolver会使用一个隐性的方法名(默认的resolver使用"handler"作为隐性的方法名,不过可以在Induction的配置文件中进行修改).

Dynamic reloading

我们来找点乐子,修改一下controller中打印的字符串的值,编译后重新刷新你的浏览器,你会发现修改起了作用.不必再经过"创建war包->重新部署->等待"的过程了.

Conclusion

总结一下我们的指南.在指南中,我们讨论了一些关键的思想,在接下来的view Tutorial中会介绍在Induction中如何使用views.Modles会在Modles Tutorial中进行介绍.

littleQ 2008-07-31 22:17 发表评论

Getting Started with Induction-翻译(1)

littleQ — Wed, 30 Jul 2008 14:16:00 GMT

欢迎使用Induction！Induction是使用java编程语言进行web应用开发的健壮高性能的框架。Induction属于基于请求的web框架，作为一个servlet部署在servlet容器中。Induction宣扬MVC的方法进行web应用开发。Induction的几个关键设计目标是：
1.当modles，views和controllers发生变化时，消除对web应用程序必须重载的需求（我们相信一次简单的页面刷新就足够了）
2.modles，views，controllers之间的绑定是声明式的，这种方式可以在任何IDE中都能被解析
3.使得数据跟踪在用户界面模板中可用（尤其是HTML模板）
4.文件上传处理应该简单到很平凡的地步
5.在HTML表格中，数组（arrays）和字典类型（dictionary types ）的使用应该尽可能简单
6.明智的使用XML（在每个应用程序中，Induction只需要一个XML文件）
7.是一种能够适应多种pattern应用的可扩充的架构
8.高性能
9.从JDK1.4到1.6都兼容（包括1.4和1.6）

About this tutorial
这份指南的目的是让你更快的使用Induction。Induction需要一个servlet容器。在这份指南中，我们使用Apache的Tomcat，不过你可以选择使用任何服从标准的servlet容器。

Installing
我们假设你已经在c:/dev/Tomcat6安装了Tomcat6。Induction本身不需要任何的安装步骤，它的jar包可以很容易地引入到你的web应用程序中。

Writing our first application - hello world
在这份指南中，我们会写一个简单的"hello world"应用，在这个应用里我们会列举出Induction的许多重要概念。

Writing a controller
首先我们写一个controller作为我们指南的开始，因为controllers是web应用程序中一个典型的entry。好，现在让我们开始写一个controller，让它在浏览器中打印一串字符。


package demoapp.helloworld1_app;

 

import com.acciente.induction.controller.Controller;

import com.acciente.induction.controller.Response;

import java.io.IOException;



/** *//**

 * A very simple controller that does the customary "Hello World"

  */

public class HelloWorldController implements Controller

{

   public void handler( Response oReponse ) throws IOException

   {

      oReponse.setContentType( "text/plain" );

      oReponse.out().println( "Hello World, using a simple println()" );

   }

} 


在我们运行这个controller之前，先仔细的看一下。首先我们注意到HelloWorldController类实现了Induction的Controller，Controller接口只是一个简单的标记接口，没有定义任何方法给它的实现类。当Induction接收到一个request请求后，激活一个Controller实现，比如HelloWorldController类，Induction首先核实这个类是否是实现Controller接口。因此目前Controller接口的存在的唯一理由是安全（主要考虑到Controller接口的可配置性）。因为Controller只是一个标记性接口，所以handler方法并不是接口定义的。 



接下来，我们可以看到handler方法有一个Response参数，Response类是继承javax.servlet.http.HttpServletResponse接口，并简单的对servlet容器的response对象进行了封装。Induction通过注入的方式，将参数Response值传给handler方法。一些能够作为handler参数的值，也是通过自动注入的方式，只要它们是遵循以下类型： 


    
        
            Type 
            Description 
        
        
            Request 
            facade to the servlet request, extends javax.servlet.http.HttpServletRequest 
        
        
            Response 
            facade to the servlet response, extends javax.servlet.http.HttpServletResponse 
        
        
            Form 
            provides access to the HTML form (if any) submitted with this request 
        
        
            ControllerResolver.Resolution 
            provides access to the controller resolution object (very useful for writing generic parameterized controllers) 
        
        
            model_class_name 
            instance of a user provided model class, the instance is managed to conform to a user specified lifecycle 
        
    



上面的类名是不完整的，Request, Response和Form类的更多信息，在package com.acciente.induction.controller中查看。
 
原文地址：http://www.inductionframework.org/getting-started-tutorial.html
先翻译一部分放上来，后面的会尽快贴出。
翻译的不通畅的地方，请见谅~

littleQ 2008-07-30 22:16 发表评论

Type	Description
`Request`	facade to the servlet request, extends javax.servlet.http.HttpServletRequest
`Response`	facade to the servlet response, extends javax.servlet.http.HttpServletResponse
`Form`	provides access to the HTML form (if any) submitted with this request
`ControllerResolver.Resolution`	provides access to the controller resolution object (very useful for writing generic parameterized controllers)
`model_class_name`	instance of a user provided model class, the instance is managed to conform to a user specified lifecycle

BlogJava-littleQ-随笔分类-induction

Getting Started with Induction-翻译(2)

Getting Started with Induction-翻译(1)