获取用户的msn和邮箱联系人列表，支持的邮箱包括hotmail, gmail, yahoo, sohu, sina, 163, 126, tom, yeah, ...

http://code.google.com/p/contact-list/

 

获取用户的msn和邮箱联系人列表，支持的邮箱包括hotmail, gmail, yahoo, sohu, sina, 163, 126, tom, yeah, 189和139。

contactlist项目首页和jar包下载在http://code.google.com/p/contact-list/

contactlist项目源代码在http://github.com/flyerhzm/contactlist , google code svn不再更新

Service:

contactlist提供web api调用，必须使用HTTP POST请求，接口如下：

url

:

 https

:

//123.183.209.87:8443/ContactListService/contacts


parameters

:

 account

=

xxx@gmail

.

com

&

password

=

xxxx

&

type

=

gmail

返回json格式如下：

正确的结果：

{

'contacts'

:

 

[{

'username'

:

 

'yyy'

,

 

'email'

:

 

'yyy@gmail.com'

},

 

{

'username'

:

 

'zzz'

,

 

'email'

:

 

'zzz@hotmail.com'

}]}

错误的结果：

{

'error'

:

 

'hotmail protocol changed'

}

ruby客户端: http://github.com/flyerhzm/contactlist-client

web客户端： http://contactlist.heroku.com

Example:

try

 

{


    

ContactsImporter

 importer 

=

 

ContactsImporterFactory

.

getHotmailContacts

(

username

,

 password

);


    

List

<

Contact

>

 contacts 

=

 importer

.

getContacts

();


    

for

 

(

Contact

 contact 

:

 contacts

)

 

{


        

System

.

out

.

println

(

contact

.

getUsername

()

 

+

 

": "

 

+

 contact

.

getEmail

());


    

}




}

 

catch

 

(

ContactsException

 ex

)

 

{


    ex

.

printStackTrace

();




}

Encoding:

项目的输出统一为UTF-8。 对于运行在locale为UTF-8环境（如：Ubuntu, Mac OS X）下的程序，无需任何调整。 对于运行在locale为GBK环境（如：Windows XP）下的程序，需要手动调整编码：

try

 

{


    

ContactsImporter

 importer 

=

 

ContactsImporterFactory

.

getHotmailContacts

(

username

,

 password

);


    

List

<

Contact

>

 contacts 

=

 importer

.

getContacts

();


    

for

 

(

Contact

 contact 

:

 contacts

)

 

{


        

String

 username 

=

 

new

 

String

(

contact

.

getUsername

().

getBytes

(

"UTF-8"

),

 

"GBK"

);


        

System

.

out

.

println

(

username 

+

 

": "

 

+

 contact

.

getEmail

());


    

}




}

 

catch

 

(

ContactsException

 ex

)

 

{


    ex

.

printStackTrace

();




}

另外，在windows下面需要把项目的编码设置为UTF-8，并且确保java文件的编译是用UTF-8的

Project Introduction:

contact-list类库依赖包之commons-httpclient -- http://www.huangzhimin.com/entries/142-contact-list-library-dependency-of-commons-httpclient

contact-list类库依赖包之msnmlib -- http://www.huangzhimin.com/entries/147-contact-list-library-dependency-of-msnmlib

contact-list类库依赖包之json -- http://www.huangzhimin.com/entries/158-contact-list-of-the-json-library-dependency

contact-list类库依赖包之gdata -- http://www.huangzhimin.com/entries/162-contact-list-of-the-gdata-library-dependency

持续更新中...

How to run unit test:

出于安全的考虑，没有把单元测试中的邮箱配置文件和msn配置文件放到svn上，如果需要运行mvn test的话，可以按以下步骤：

1. 新建src/test/resources/email.properties文件，形式如下：

gmail

.

username 

=

 xxx@gmail

.

com
gmail

.

password 

=

 yyy

hotmail

.

username 

=

 xxx@hotmail

.

com
hotmail

.

password 

=

 yyy

livecn

.

username 

=

 xxx@live

.

cn
livecn

.

password 

=

 yyy

onesixthree

.

username 

=

 xxx@163

.

com
onesixthree

.

password 

=

 yyy

onetwosix

.

username 

=

 xxx@126

.

com
onetwosix

.

password 

=

 yyy

sina

.

username 

=

 xxx@sina

.

com
sina

.

password 

=

 yyy

sohu

.

username 

=

 xxx@sohu

.

com
sohu

.

password 

=

 yyy

tom

.

username 

=

 xxx@tom

.

com
tom

.

password 

=

 yyy

yahoo

.

username 

=

 xxx@yahoo

.

com
yahoo

.

password 

=

 yyy

yahoocn

.

username 

=

 xxx@yahoo

.

cn
yahoocn

.

password 

=

 yyy

yahoocomcn

.

username 

=

 xxx@yahoo

.

com

.

cn
yahoocomcn

.

password 

=

 yyy

yeah

.

username 

=

 xxx@yeah

.

net
yeah

.

password 

=

 yyy

oneeightnine

.

username 

=

 xxx@189

.

cn
oneeightnine

.

password 

=

 yyy

onethreenine

.

username 

=

 xxx@139

.

com
oneeightnine

.

password 

=

 yyy

2. 新建src/test/resources/msn.properties文件，形式如下：

username 

=

 xxx@live

.

cn
password 

=

 yyy

3. 在命令行执行mvn test

Change Log:

• 1.1:

First public release

• 1.2:

Fix issue that hotmail can only get first page contact list

• 1.3:

Fix issue for some special sohu mail account

• 1.4:

Fix issue that 163 mail can only get other group contacts

• 1.5:

Fix issue that 126 and yeah mail can only get other group contacts

• 1.6:

Add 189 and 139 mail support

• 1.6.1:

Meet another style 189 mail and add 139 mail importer to ContactsImporterFactory

• 1.7.0:

Get google contacts by gdata api

• 1.8.0:

Get hotmail contacts by windows live contacts api

• 1.9.0:

Better parser for yahoo and tom mail

• 1.10.0:

Use passportName as email for hotmail

• 1.11.0:

Fix 139 for web change and fix 126 and yeah mail when username is empty

• 1.12.0:

Get msn contacts by window live contacts api

Other:

需要留言的话，可以上http://github.com/flyerhzm/contactlist/issues ，我会尽快回复的

由 于这个类库的原理是使用抓取网页来分析联系人列表的，所以会因为邮箱网页的改版而无法正确获取联系人列表。 如果大家在使用的时候发现有邮箱不能获得联系人列表，希望先把类库log4j的level设置为debug，把调试信息和错误信息一起发送给我 flyerhzm@gmail.com，我会尽快解决问题的，谢谢！