open-qq


QQ OpenAPI for Java&Android

公告

腾讯官方已经提供,不再更新,源码可以帮助学习了解
麻烦关注https://github.com/lamb'>@Lamb

关于签名值错误:包含这三个字符会签名值错误,请自己替换(将英文换成中文)

  • sendContent = sendContent.replaceAll("!", "!");
  • sendContent = sendContent.replaceAll("\\(", "(");
  • sendContent = sendContent.replaceAll("\\)", ")");

作用

通过“QQ登录”,用户能使用QQ帐号一键登录接入网站,大大降低了用户注册、登录的门槛,借助庞大的QQ用户群,给第三方网站带来更多新用户。已登录用户还可以将在第三方网站发布、分享的信息即时同步到QQ空间,使网站内容通过好友关系得到进一步的传播,从而提升网站的访问量和用户数。

前提准备

  • 在开始搭建开发环境之前,您必须掌握如下知识或技能
  1. 能够使用 Java 开发应用程序;
  2. 对OAuth、QQ开放平台有一定了解;
  3. 熟悉 Maven2+,SVN;

    不熟悉Maven,SVN

  • 可以直接导入Eclipse Dynamic Web Project项目名demo-nop
  • 或手动拷贝相关文件至您熟悉的环境(以Eclipse Web项目为例,我们叫这个项目为Q项目)
  1. 下载connect-1.x-all-in-one.zip,解压至当前文件夹
  2. 拷贝demo/src/main/java中的所有文件至Q项目src目录
  3. 拷贝demo/src/main/resources中的所有文件至Q项目src目录
  4. 拷贝demo/src/main/webapp中的所有文件至Q项目WebRoot(或叫WebContent)下
  5. 拷贝lib目录下所有的jar包至Q项目WebRoot(或叫WebContent)/WEB-INF/lib下(servlet-api-2.5.jar如果容器已经包含就不必添加)

    在项目中添加Maven依赖

    <dependency>
    <groupId>com.qq

    Unknown end tag for </groupId>

    <artifactId>connect

    Unknown end tag for </artifactId>

    <version>1.3.0

    Unknown end tag for </version>

    <scope>compile

    Unknown end tag for </scope>



    Unknown end tag for </dependency>

<repository>
<id>release

Unknown end tag for </id>

<name>Lamb at Google Maven repository of release

Unknown end tag for </name>

<url>http://m2-rep.googlecode.com/svn/release

Unknown end tag for </url>

<snapshots>
<enabled>false

Unknown end tag for </enabled>



Unknown end tag for </snapshots>

<releases>
<enabled>true

Unknown end tag for </enabled>



Unknown end tag for </releases>



Unknown end tag for </repository>

开始搭建

  • Connect是使用Maven2进行的项目构建,所以并不依赖于任何一款Java IDE,只要支持Maven的IDE都可以进行调试和开发。

    NetBeans配置

  1. 工具->选项->其他->Maven->外部&Maven主页->浏览 把 Maven 的路径加上
  2. 用 SVN 把项目迁出 http://open-qq.googlecode.com/svn/trunk/demo'>http://open-qq.googlecode.com/svn/trunk/demo
  3. 运行项目。右键项目,定制-> jetty:run

    Eclipse配置

  4. 安装 Maven 的插件:The Maven Integration for Eclipse
  5. Window->Preferences->Maven->installations->Add 把 Maven 的路径添加上
  6. 用 SVN 把项目迁出 http://open-qq.googlecode.com/svn/trunk/demo'>http://open-qq.googlecode.com/svn/trunk/demo
  7. 右键项目,选择Configure --> Convert to Maven Project
  8. 右键项目,选择run as maven build...-->Goals:eclipse:eclipse静静等待Build成功即可
  9. 右键项目,选择刷新(refresh)
  10. 运行项目。右键项目,run as maven build... --> Goals: jetty:run

    启动配置

  • 前提条件已经申请到QQ互联的APPID APPKEY
  1. 在demo中找到src/main/resources/connect.properties这个文件
  2. 正确填写APP_ID, APP_KEY, OAUTH_CALLBACK

    本地测试

  • 前提准备,了解本地Host文件的作用
  1. 找到C:\WINDOWS\system32\drivers\etc\hosts这个文件
  2. 用文本方式打开
  3. 增加一行:127.0.0.1 www.domain.com
  4. 启动本地服务器
  5. 启动浏览器访问http://www.domain.com/projectname

    其他

  • 下载:http://code.google.com/p/open-qq/downloads/list'>http://code.google.com/p/open-qq/downloads/list
  • QQ群:13139268
  • 注:众人拾柴火焰高,欢迎各位反馈使用中的bug。
  • 报告issue请来:http://code.google.com/p/open-qq/issues/list'>http://code.google.com/p/open-qq/issues/list
  • 站内信或者下面方式
  • 微博:http://weibo.com/lambsand'>@金氧
  • 邮箱:lamb52gao#gmail.com
  • 博客:http://lamb.b3log.org'>http://lamb.b3log.org

  • Project Information

    The project was created on May 16, 2011.

    Labels:
    java QQ OpenSocial OpenID OAuth OpenAPI