addressparse.java

基于java的组号查询模块

/**
 * 
 */
package com.lily.dap.service.common;

import java.util.List;
import java.util.Set;

/**
 * 操作地址分析接口，实现对组织机构、邮件地址、通讯录的地址的分析操作，包括：根据地址获取显示名称，分析地址内容的有效性
 * 
 * @author zouxuemo
 *
 */
public interface AddressParse {
	/**
	 * 判断给定的地址是否是支持的地址格式（xx@department xx@post xx@person xx@group）
	 * 
	 * @param address
	 * @return
	 */
	public boolean isAddressFormat(String address);
	
	/**
	 * 检索地址信息集合字符串，检查是否有错误及被删除的地址，剔除错误地址，返回纯净后的地址集合
	 * 
	 * @param addresss
	 * @return
	 */
	public String purify(String addresss);
    
    /**
     * 分析地址格式（格式如：xxx◎department）,解析出实际的地址，返回实际地址Set集合
     * 
     * @param address
     * @return
     */
    public Set parse(String addresss);
    
    /**
     * 检索地址信息集合字符串，将地址转换为字符串的list
     * @param addresss  格式如：xxx◎department,xxx@post,xxx@person
     * @return List{"xxx@person","xxx@post","xxx@person"}
     */
    public List parseToList(String addresss);
    
    /**
     * 检索list，转化为字符串地址格式
     * @param list List{"xxx@person","xxx@department","xxx@post"}
     * @return "xxx@person,xxx@department,xxx@post"
     */
    public String parseFromList(List list);
    
    /**
     * 检索地址信息集合字符串，将地址转换为字符串的Set
     * @param addresss  格式如：xxx◎department,xxx@post,xxx@person
     * @return Set{"xxx@person","xxx@post","xxx@person"}
     */
    public Set parseToSet(String addresss);
    
    /**
     * 检索Set，转化为字符串地址格式
     * @param set Set{"xxx@person","xxx@department","xxx@post"}
     * @return "xxx@person,xxx@department,xxx@post"
     */
    public String parseFromSet(Set set);
    
    /**
     * 判断某人是否在地址参数中
     * @param person_id 人员id
     * @param addresss 地址参数,1@person,2@post,3@department,4@group
     * @return 如果人员包含在地址中,返回true;否则,返回false.
     */
    public boolean isPersonInAddress(long person_id, String addresss);
    
    /**
     * 分析地址格式（格式如：xxx◎department），解析出实际的地址，并添加到地址Set集合中
     * 
     * @param address
     * @param set
     * @return
     */
    public Set parseAndInsertSet(String addresss, Set set);
    
    /**
     * 返回给定地址（格式如：xxx◎department）的别名，如果地址没有别名，返回该地址字符串
     * @param address
     * @return
     */
    public String alias(String addresss);
}