ShareLoginLib代码框架结构

概述
ShareLoginLib是一个可以使用第三方登录以及分享的库，以下解决几个关于源码的问题。
本文解决以下问题

• 代码执行的流程，如何进行的分享或登录。
• 需要分享得内容有很多种，他是如何兼顾的。
• 初始化的时候干了什么
• 分享过程中干了什么
• 分享成功还是失败如何知道
• 整个代码的流程以及框架

---

先来一张流程图了解一下大致的使用：

流程图.png

• ShareContent接口
  分享的内容接口，所有的分享内容类都需要实现该接口，然后通过type来说明具体是什么类型

int TEXT = 1, PIC = 2, WEBPAGE = 3, MUSIC = 4;

public interface ShareContent {
    int NO_CONTENT = 31415926;
    /**
     * @return 分享的方式
     */
    @ShareContentType
    int getType();
    /**
     * 分享的描述信息(摘要)
     */
    default String getSummary() {
        return null;
    }
    /**
     * 分享的标题
     */
    default String getTitle() {
        return null;
    }
    /**
     * 获取跳转的链接
     */
    default String getURL() {
        return null;
    }
    /**
     * 分享的缩略图片
     */
    default byte[] getThumbBmpBytes() {
        return null;
    }
    /**
     * 分享的大图地址
     */
    default String getLargeBmpPath() {
        return null;
    }
    /**
     * 音频url
     */
    default String getMusicUrl() {
        return null;
    }
}

• ​OAuthUserInfo:
  ​字段：nickName，sex，headImgUrl，userId

• ShareListener/LoginListener implements IBaseListener
  处理分享后的回调，具体实现登录以及分享的方法中需要传入ShareListener/LoginListener的实例，由业务层实现相应失败或成功等状态需要做的处理。

• ShareLoginLib
  核心分享类，起到调度作用，个人理解使用了外观模式
  构造时需要传入Map<String , String> mValueMap以及List<Class<? Extends Iplatform>> supportPlatforms;

    public static void initPlatforms(Map<String, String> keyValue, List<Class<? extends IPlatform>> platforms) {
        sValueMap = keyValue;
        supportPlatforms = platforms;
    }

核心操作doShare和doLog方法都由doAction（）方法实现

doAction（）方法会传入当前Activity，判断是否是登陆操作的flag，分享的目标String type ， 分享的内容ShareContent，以及LoginListener和ShareListener。

doAction（）方法中

1. 首先会创建ArrayList包含目前支持的平台，

2. 然后根据传入的type在supportPlatforms中遍历匹配一个目标平台。

3. 之后会调用各个平台类xxxxPlatform.checkEnvironment()检测当前运行环境查看是否正常。

4. 启动辅助的Activity执行最终的具体操作，会调用具体的xxxxPlatform.doLogin或doShare方法

 private static void doAction(Activity activity, boolean isLoginAction, @NonNull String type, @Nullable ShareContent content,
            LoginListener loginListener, ShareListener shareListener) {

        // 1. 得到目前支持的平台列表
        ArrayList<IPlatform> platforms = new ArrayList<>();

        for (Class<? extends IPlatform> platformClz : supportPlatforms) {
            platforms.add(SlUtils.createPlatform(platformClz));
        }

        // 2. 根据type匹配出一个目标平台，最终调用这个具体平台的方法

        @Nullable IPlatform curPlatform = null;

        for (IPlatform platform : platforms) {
            for (String s : platform.getSupportedTypes()) {
                if (s.equals(type)) {
                    curPlatform = platform;
                    break;
                }
            }
        }

        // 3. 初始化监听器
        if (loginListener == null) {
            loginListener = new LoginListener();
        }

        if (shareListener == null) {
            shareListener = new ShareListener();
        }

        // 4. 检测当前运行环境，看是否正常
        try {
            if (curPlatform == null) {
                throw new UnsupportedOperationException("未找到支持该操作的平台，当前的操作类型为：" + type);
            } else {
                curPlatform.checkEnvironment(activity, type, content != null ? content.getType() : ShareContent.NO_CONTENT);
            }
        } catch (Throwable throwable) {
            if (isLoginAction) {
                loginListener.onError(throwable.getMessage());
            } else {
                shareListener.onError(throwable.getMessage());
            }
            return;
        }

        // 5. 启动辅助的activity，最终执行具体的操作

        final LoginListener finalLoginListener = loginListener;
        final ShareListener finalShareListener = shareListener;
        final IPlatform finalCurPlatform = curPlatform;

        ShareLoginLib.onCreateListener = eventActivity -> {
            if (isLoginAction) {
                finalCurPlatform.doLogin(eventActivity, finalLoginListener);
            } else {
                assert content != null;
                finalCurPlatform.doShare(eventActivity, type, content, finalShareListener);
            }
        };
        activity.startActivity(new Intent(activity, EventHandlerActivity.class));
        activity.overridePendingTransition(android.R.anim.fade_in, android.R.anim.fade_out);

        wrPlatform = new WeakReference<>(curPlatform);
    }

• IPlatForm接口
  定义平台特性，需要实现doShare，doLogin以及onResponse，getUserInfo，checkEnviroment，isAppInstalled等方法。官方已经实现了微博，QQ，微信三个常用平台，如果还需要再添加平台的话需要自己创建Platform类实现IPlatForm接口。
  不同的平台对应三个类，一个platform类实现IPlatForm，一个LoginHelper类和一个ShareHelper类。

Platform类 中实现实际的share和login操作如下代码：

@Override
public void doShare(Activity activity, String shareType, @NonNull ShareContent shareContent, @NonNull ShareListener listener) {
    uiListener = new LoginHelper.AbsUiListener(listener) {
        @Override
        public void onComplete(Object o) {
            listener.onSuccess();
        }
    };

    Tencent tencent = getTencent(activity);

    if (shareType.equals(FRIEND)) {
        tencent.shareToQQ(activity, ShareHelper.qqFriendBundle(shareContent), uiListener);
    } else {
        // 因为空间不支持分享单个文字和图片，在这里对于单个图片做了额外的处理，让其走发布说说的api
        if (shareContent.getType() == ShareContentType.TEXT || shareContent.getType() == ShareContentType.PIC) {
            tencent.publishToQzone(activity, ShareHelper.publishToQzoneBundle(shareContent), uiListener);
        } else {
            tencent.shareToQzone(activity, ShareHelper.zoneBundle(shareContent), uiListener);
        }
    }
}

---

LoginHelper类
主要的作用就是想服务器发送给等登录请求，对服务器返回的信息做解析，具体的网络请求由Utils包中的类来实现。提供GetUserInfo等方法获取用户信息。

ShareHelper类
通过构建Bundle、Intent或具体要分享得平台所提供的信息体来将要传输的数据包裹，然后在对应的platform类中通过腾讯或者微博等平台提供的方法发送数据。