BAMS 二次开发文档

Android版介绍

发布时间 2015-05-30 15:51   浏览量()   收藏()

项目简介

信息化行业对于移动应用的需求越来越多,出于个人兴趣,老高我也开始学习Android开发了。老高接触Android只有几个月,开发经验不是很足,在app的架构设计,技术细节上可能会有不妥之处,希望大家能积极指出,一同改进BAMS安卓版。

在学习过程中发现Android的界面开发模式跟Swing非常相似,如果你有Swing基础,上手Android开发会更加容易的。

在学习BAMS安卓版的过程中,有什么技术问题都可以在 品互网络 技术分享 - 安卓开发中查看,也可以在交流论坛提出问题,老高会尽快回复的。

BAMS Android版的服务端目前是基于BAMS演示系统的,你可以使用BAMS演示系统的账户进行登录,例如 dxj、lisi等等,密码均为111111(6个1)。你也可以在演示系统上发布公告,Android客户端即可看到公告。


项目源码下载

点击下载源码


项目架构浅析

framework 应用框架层

    controller包 负责和服务端进行交互

        AsynCommon.java 常用业务和服务端的交互模式     使用AsyncTask模式进行交互,关于 AsyncTask和Handler对比

        AsynDocDownLoadLoader.java 附件下载

        AsynUpgrade.java 应用升级

        Controller.java 控制器入口,在UI层被调用

        ErrorListener.java 请求结果监听器,在AsyncTask onPostExecute方法中使用

        Handler.java http请求处理器

    exception包  定义了常用的异常,如超时、无网络等等

    http包  封装了http的建立、参数解析、get和post请求等功能

    util包  常用工具包,如文件、json解析、xml解析、日志、提示等等

    ConfigProperties.java 应用配置文件,需要配置公司码、服务端接口地址、更新文件地址等等

    Constants.java 常量定义

    ErrorCode.java 错误码定义

    Params.java 参数封装

    Url.java 服务端接口地址定义

    UrlType.java 服务端接口类型定义

view 界面UI层

    (省略)...界面编程通常有三个概念,组件、事件、布局,新人可以从这三点开始学习。


服务端接口规范

BAMS安卓客户端和服务端交互使用的是http协议,json数据格式。关于BAMS安卓版服务端源码,请下载最新版的BAMS开发框架,服务端接口也是基于BAMS开发框架的,没有进行分离。

在开发功能之前需要设计好接口的参数和返回值。

V1.0版本实现了三个接口。

1、用户登录接口

地址http://项目地址/mobile/loginCheck.do
参数companyCode(公司码)、username(用户名)、password(密码)
返回值

code(返回码)  0表示成功 其他表示失败

errorMsg(错误信息)

name(用户真实姓名) 如果登录成功,将返回用户姓名,存放在安卓客户端。

sessionId(用户登录标志)sessionId将会存放在安卓客户端,安卓客户端发起的大部分请求必须携带sessionId,服务端会根据sessionId进行登录验证。

//失败返回的数据
{
    "code": 1, 
    "errorMsg": "公司码不存在或者已过期!"
}
//成功返回的数据
{
    "code": 0, 
    "name": "狄晓靖", 
    "sessionId": "E760FB5A0FBCD3B04FC487EE5D82A821"
}


2、公告列表接口

3、公告详情接口

广告会让浏览体验不好,可这是网站的唯一收入,请点击下面的百度广告,支持老高的开源行动吧!