#Controller类
Details
package controller;
import java.util.*;
import model.*;
/**
* PhoneMe通讯录软件的控制层
* @author 王喆
* 创建于2009.4.12
*/
class Controller {
/**
* 储存所有信息,所有操作均对此结构进行修改
*/
private Model myModel;
/**
* 构造函数
*/
public Controller(){
}
//*****************************************************************************************//
//组操作
/**
* 返回所有组信息
* @return 以Vector形式返回所有的组信息
*/
public Vector<Group> getGroups(){
return new Vector<Group>();
}
/**
* 新建组
* @param groupname 组名
* @return 返回成功或错误信息,若创建成功,返回'#',若失败将返回失败信息
*/
public String newGroup(String groupname){
String message = "#";
return message;
}
/**
* 修改组名
* @param oldname 旧的组名
* @param newname 新的组名
* @return 返回成功或错误信息,若创建成功,返回'#',若失败将返回失败信息
*/
public String editGroupName(String oldname, String newname){
String message = "#";
return message;
}
/**
* 修改组成员
* @param ids 组成员的id
* @return 返回成功或错误信息,若创建成功,返回'#',若失败将返回失败信息
*/
public String editGroupContent(Vector<Integer> ids){
String message = "#";
return message;
}
/**
* 删除组,只删除组不删除其中联系人
* @param groupname 要删除的组的组名
* @return 返回成功或错误信息,若创建成功,返回'#',若失败将返回失败信息
*/
public String deleteGroup(String groupname){
String message = "#";
return message;
}
//*****************************************************************************************//
//联系人操作
/**
* 提供组名,返回组内成员信息
* @param groupname 组名(如果希望得到所有联系人信息,请把该参数值为"#")
* @return 以Vector形式返回组内成员信息
*/
public Vector<Person> getPersons(String groupname){
return new Vector<Person>();
}
/**
* 提供联系人id,返回该联系人详细信息
* @param id 联系人id
* @return Person类型的联系人详细信息
*/
public Person getPersonInfo(String id){
return new Person();
}
/**
* 新建一个联系人
* @param att 该Vector内储蓄所有新建联系人的信息,联系人各项信息的保存顺序再行规定
* @return 返回成功或错误信息,若创建成功,返回"#",若失败将返回失败信息
*/
public String newPerson(Vector<String> att){
String message = "#";
return message;
}
/**
* 修改联系人信息
* @param att 该Vector内储蓄所有新建联系人的信息,联系人各项信息的保存顺序再行规定
* @return 返回成功或错误信息,若创建成功,返回'#',若失败将返回失败信息
*/
public String editPerson(Vector<String> att){
String message = "#";
return message;
}
/**
* 删除一个联系人
* @param id 联系人id
* @return 若成功返回“#”,失败则返回失败信息
*/
public String deletePerson(String id){
String message = "#";
return message;
}
//*******************************************************************************************//
//其他服务
/**
* 导入文件
* @param uri 文件uri地址
* @return 若成功返回“#”,失败则返回失败信息
*/
public String importFile(String uri){
String message = "#";
return message;
}
/**
* 导出文件
* @param path 导出文件路径
* @param filename 文件名
* @param type 文件类型 1为vCard类型,2为csv类型
* @return 若成功返回“#”,失败则返回失败信息
*/
public String exportFile(String path, String filename, int type){
String message = "#";
return message;
}
/**
* 在关闭程序或其他需要的时候进行所有数据的保存
* @return 若成功返回“#”,失败则返回失败信息
*/
public String save(){
String message = "#";
return message;
}
/**
* 联系人查询
* @param query 查询内容
* @param type 查询类型 1为姓名查询,2为手机号查询,3为email地址查询,4为联系人关系查询
* @return 查询结果
*/
public Vector<Person> search(String query, int type){
return new Vector<Person>();
}
/**
* 与google contact同步
* @param name 用户名
* @param password 密码
* @return 若成功返回“#”,失败则返回失败信息
*/
public String synchronize(String name, String password){
String message = "#";
return message;
}
/**
* 显示关系图(即人立方)
* @param groupname 要显示的组名或者全部,全部显示该属性置为“#”
* @return 若成功返回“#”,失败则返回失败信息
*/
public String getRelationGraph(String groupname){
String message = "#";
return message;
}
}