0
点赞
收藏
分享

微信扫一扫

ShareLoginLib代码框架结构

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

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

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

  • ShareContent接口
    分享的内容接口,所有的分享内容类都需要实现该接口,然后通过type来说明具体是什么类型
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类中通过腾讯或者微博等平台提供的方法发送数据。

举报

相关推荐

0 条评论