Apache Usergrid/developer

Apache Usergrid 开发者

编译

2.x 编译

因为引入了 elasticsearch 所以编译环境有了更多要求，参考：Usergrid 2.1.0 Deployment Guide

1.x 编译

注意要使用 cassandra 2.x, tomcat 7.x 的版本 (不要使用3.x, 9.x的高版本)，使用的 Usergrid 1.0.2。

下载后进入stack目录，执行：mvn clean install -DskipTests=true

成功编译生成 stack/rest/target/ROOT.war

将tomcat/webapps/ROOT目录删除，将ROOT.war复制到tomcat的webapps目录下。

在tomcat的lib目录下创建 usergrid-custom.properties 文件：

usergrid.sysadmin.login.allowed=true
usergrid.sysadmin.login.name=superuser
usergrid.sysadmin.login.password=pw123
[email protected]
[email protected]
usergrid.management.mailer=Myself<[email protected]>
[email protected]
usergrid.test-account.admin-user.password=test

设置用户数据库和管理数据库

http://localhost:8080/system/database/setup
http://localhost:8080/system/superuser/setup

查查数据库

cqlsh> use system;
cqlsh:system> select * from schema_keyspaces;
cqlsh:system> use usergrid;
cqlsh:usergrid> desc keyspaces;
cqlsh:usergrid> desc tables;
cqlsh:usergrid> desc schema;

系统状态

http://localhost:8080/status

编译部署Portal，需要node.js，参考目录下的README.md文件

可运行一个单独的轻量服务器 http://localhost:3000 也可部署到 tomcat 上。(最好单独部署，并部署到内网)

Usergrid_Applications' does not exist

performance编译

grunt --gruntfile Perf-Gruntfile.js dev

Portal

usergrid-1.0.2/stack/config/src/main/resources/usergrid-default.properties

usergrid.sysadmin.login.name=huihoo 
[email protected]
usergrid.sysadmin.login.password=huihoo
usergrid.sysadmin.login.allowed=true
usergrid.sysadmin.approve.users=false
usergrid.sysadmin.approve.organizations=false

修改编译重新部署

常见问题：Cannot login to Apache Usergrid deployed on Tomcat7

Apigee

Apigee Acquires Mobile App API Provider Usergrid Usergrid founder and CEO Ed Anuff has joined Apigee's leadership team, where he will continue to guide the development of Usergrid software.
REST Endpoints

https://api.usergrid.com/status
https://apigee.com/appservices

Apigee为组织默认创建了 sandbox 应用，开发者可基于它进行curl操作。如，同时创建 collection 和 entity

curl -X POST "https://api.usergrid.com/huihoo/sandbox/item" -d '{"name":"milk", "price":"3.25"}'

一步步来，先创建一个 book 的 collection ，并 post 第一本书

{ "name":"Effective Akka" }

然后

curl -X PUT https://api.usergrid.com/{huihoo}/sandbox/books/?ql= -d '{ "author" : "Allen" }'
curl -X GET https://api.usergrid.com/{huihoo}/sandbox/books

更多细节>>>

图片,asset, file 管理：

curl -X POST -i -F name='image1' -F [email protected] 'https://api.usergrid.com/huihoo/sandbox/pictures/'
curl -X GET -H 'Accept: image/jpeg' 'https://api.usergrid.com/huihoo/sandbox/pictures/image1'

通知服务

注册 Apple APNs or Google GCM

数据库存储

关系型数据库、Cassandra、Usergrid对应关系

Relational	Cassandra	Usergrid
A row.	A row.	An entity. 存储为JSON file
A column.	A column. 支持数以千计的列	A entity property. 也包含entity’s UUID
A table.	A column family.	An entity collection.

关系型数据库

Cassandra

JSON 文件

 { 
    "action" : "get", 
    "application" : "<app_uuid>", 
    "params" : {}, 
    "path" : "/products", 
    "uri" : "https://api.usergrid.com/my_org/my_app/products", 
    "entities" : [ { 
        "uuid" : "<product_uuid>", 
        "type" : "product", 
        "created" : 1395410098517, 
        "modified" : 1395410098517, 
        "image" : "http://path.jpg", 
        "metadata" : { 
            "path" : "/products/<product_uuid>" 
        }, 
        "name" : "Bouncy Castle", 
        "sku" : "35450349822" 
    }, 
    {
        "uuid" : "<product_uuid>", 
        "type" : "product", 
        "created" : 1395409669686, 
        "modified" : 1395409669686, 
        "image" : "http://path.jpg", 
        "metadata" : { 
            "path" : "/products/<product_uuid>" 
        }, 
        "description" : "It makes coffee.", 
        "name" : "Coffee Maker", 
        "sku" : "60723023589" 
    }, 
    { 
        "uuid" : "<product_uuid>", 
        "type" : "product",
        "created" : 1395407700578, 
        "modified" : 1395407700578, 
        "metadata" : { 
            "path" : "/products/<product_uuid>" 
        }, 
        "name" : "Air Mattress", 
        "sku" : "53045985365" 
    }],
    "timestamp" : 1396290037640, 
    "duration" : 91, 
    "organization" : "my_org", 
    "applicationName" : "my_app", 
    "count" : 3 
}

Eclipse

导入Usergrid mvn项目，会自动importing Maven项目，或者：

cd stack
mvn clean package -DskipTests=true

IDEA

测试框架

Judo chop

代码覆盖

使用 JaCoCo Java Code Coverage Library 做代码覆盖测试。

持续集成

图集

Apple APNs
Google GCM
安全和身份认证
Apigee
API性能

链接