appweb的开发步骤简介

发表时间：2014-8-22

发布人：葵宇科技

浏览次数：53

之前的博客上讲了开发板上移植appweb的过程，这篇博客就记录一下如何开发一个典型的基于appweb的mvc架构的网站

1.前言

1.1环境参数

开发板：mini2440 64MB内存 256MB Flash

PC系统：X86 ubuntu10.04 gcc：4.4.3

交叉编译器：gcc 4.4.3

appweb版本：5.0.0-rc1

1.2简介

ESP全称是Embedded Server Page，和jsp（Java Server Pages）很相似，前者支持将C语言嵌套到html中后者支持将Java语言嵌套到html中来实现动态网页。下面摘抄一点官网上的原话：

ESP is the blazing fast "C" language web framework that works at thought-speed.ESP is not a traditional low-level environment. It is a powerhouse MVC framework in a tiny footprint with most things you'd expect from an enterprise web framework including: MVC, scaffolds, templates, WebSockets, integrated databases, database migrations and more.

ESP的document：https://embedthis.com/esp/doc/index.html

AppWeb的document：https://embedthis.com/appweb/doc/index.html

其他工具的网址：https://embedthis.com/products.html

2.一个简单的MVC登录

由于开发的是嵌入式web，每改动一点内容就要重新编译然后再下载到开发板中测试，很是麻烦，所以一般采取的方法是先在PC上开发好，测试好后然后移植到开发板上。所以我们先要在PC上安装AppWeb以及其它工具，然后开发一个web应用，最后移植到开发板上。

2.1向PC上安装AppWeb

下载源码：

去网址：http://appwebserver.org/downloads/appweb/download.esp下载appweb的源码，我下载的版本是appweb5.0
编译：
（i）解压源码文件
（ii）把文件appweb-linux-default-me.h中的#define ME_COMPILER_HAS_SYNC64 1注释掉，不然会报错“undefined reference to `__sync_add_and_fetch_8'collect2: ld returned 1 exit status”
//#define ME_COMPILER_HAS_SYNC64 1
（iii）make
make -f projects/appweb-linux-default.mk

编译完后会在../appweb-5.0.0-rc1/linux-x86-default文件下生成目标文件将

(iiii)安装

make –f project/appweb-linux-default.mk install

2.2利用appweb提供的工具建立MVC模板

参考网址：https://embedthis.com/esp/doc/guide/esp/start/mvc-tour.html

这个程序很简单，就是输入用户名和密码，如果用户名是“abc”密码是“123”那么页面就跳到loginOK页面，如果不是那么页面就跳转到loginError页面。

目的是熟悉流程和简单地理解appweb，里面没有涉及到数据库，所以MVC中的M就没有很好地体现，主要是V和C，如果要完整的实现可以认真地阅读上面的参考网址。

2.2.1模板生成

(1)$ mkdirmylogin

(2)$cd mylogin

(3)$esp install esp-html-mvc

执行完(3)后会在文件夹里面出现：client layouts package.json paks这几个文件或是文件夹，将package.json中的auth中的内容type删除，不然会报错：esp: Error: Cannot find auth type app

(4)$esp generate controller login
执行(4)的目的是产生controller，执行玩了之后就会发现文件夹里面多了个文件夹controllers，里面已经自动生成了login.c

2.2.2 修改/编写View

(1)修改mylogin/client/index.esp页面为用户名密码形式,这里一定要加这句话<% inputSecurityToken(); %>不然的话会报错误：

Access Error: 401 -- Unauthorized
Security token is stale. Please reload page.

<html>
<head>
<title>MyLogin</title>
</head>

<body>
    <h1>MyLogin</h1>
    <form action=/do/login/check method=POST>
        <table>
        <tr>
            <td>Name:</td><td><input type=text name=name size=50 value=""></td>
        </tr>
        <tr>
            <td>Pwd:</td><td><input type=text name=pwd size=50 value=""></td>
        </tr>
        <tr>
            <td align="CENTER"> 
                <input type=submit name=login value="Login"> 
                <% inputSecurityToken();%>
            </td>
        </tr>
        </table>
    </form>
</body>
</html>

(2)在mylogin/client文件夹下建立app/login文件夹，在里面新建两个esp页面，login-ok.esp和login-error.esp

<html>
<head>
<title>OK</title>
</head>

<body>
    <h1>login OK</h1>
</body>
</html>

<html>
<head>
<title>error</title>
</head>

<body>
    <h1>login Error</h1>
</body>
</html>

2.2.3 修改/编写Controller
这里主要是修改controller文件夹下的login.c，这里的action的命名是这样的：比如./do/login/check的uri对应的就是login-cmd-check

/*
    login Controller for esp-html-mvc (esp-html-mvc)
 */
#include "esp.h"
static void checkLogin() {
    cchar *name = param("name");
    cchar *pwd = param("pwd");
    if(smatch("abc",name) && smatch("123",pwd))
    {
        renderView("login/login-ok");
    }else{
        renderView("login/login-error");  
    }      
}
static void common(HttpConn *conn) {
}

/*
    Dynamic module initialization
 */
ESP_EXPORT int esp_controller_mylogin_login(HttpRoute *route, MprModule *module) {
    espDefineBase(route, common);
    espDefineAction(route, "login-cmd-check", checkLogin);
    return 0;
}

2.2.3编译

$esp compile

如果没有错误的话，机会生成cache文件，里面的.so文件就是appweb要加载的文件，这里我们可以看到，esp会被“翻译”成c文件，就像jsp会被“翻译”成java文件（servlet）一样

2.2.4配置文件

为了节省空间我把不必要的注释和其它的东西都删除了，如果想看完整版（里面有很多的注释，建议看一下），就去看appweb-5.0.0-rc1/src/server/sample.conf

需要注意的是以下几个：

（1）Listen 4000 监听端口

（2）Documents /home/jxm 这个表示你的web应用所在的目录，比如我的文件夹mylogin就在/home/jxm文件夹下

（3）EspRoute name="login" methods="GET,POST" prefix="^/{controller}(~/{action}~)" target="${controller}-${action}" source="${controller}.c" 这个文件就是配置action的语句，只需要修改name就行，其它的用模板里面的就行

ErrorLog "error.log" size=10MB level=2 backup=5 anew stamp=1hr
Listen 4000

Documents /home/jxm

AddHandler fileHandler html gif jpeg jpg png pdf ico css js txt ""


<if ESP_MODULE>
    LoadModule espHandler libmod_esp
    AddHandler espHandler esp
    EspUpdate off

    EspKeepSource>
 
2.2.5启动 
 
$appweb --config sample.conf
 2.2.6访问 
向浏览器中输入网址：127.0.0.1:4000就会出现登录界面，如果要去掉最上面的“Home”banner，需要将文件夹mylogin/layouts中的default.esp文件删除，然后重新编译再运行
  

 2.2移植到开发版 
2.2.1 交叉编译 
在编译前建议将cache文件夹删除 
$export CC=arm-linux-gcc 
$esp --platform../appweb-5.0.0-r1/linux-arm-release(这个路径是你之前交叉编译appweb产生的目录) compile 
然后将整个mylogin文件拷贝到开发板中，这里需要注意的是，由于目录变化所以在sample.conf 中的Document的目录也要变