Android Studio插件开发之 - IOC注解生成器

1.概述


  上一期我们已经分享了Android Studio插件开发之 - 基础入门篇。那么现在我们来动手写一个IOC注解生成器,有点类似于ButterKnife的插件一样自动给我们生成代码,在网上找了很多资料国内基本就在HelloWorld阶段,也有很多哥们向我反应插件的代码还是有点蒙B。代码方面能理解就理解,不理解也不强求,如果你能改一改别人已经写好的插件就最好了,实在不行我们干脆也别折腾了大不了不用,本文章旨在给自己想写一些奇葩插件的哥们一些引导。
  废话不多说,请看具体效果:

GIF.gif
  自动生成注解代码,跟ButterKnife的插件类似,但是我们自己写的插件生成的注解代码更加符合google源码规范,而且是基于我们自己动手打造一套IOC注解框架。当然我们可以去参考ButterKnife的插件是怎么写的,但是我看了一下里面的东西太多了,我们干脆自己来吧。

  所有分享大纲:2017Android进阶之路与你同行

  视频讲解地址:周六晚上八点
    

2.实现


2.1 思路整理

  我们先来整理一下思路,要实现这么个插件我们需要做一些什么东东:
- 获取光标所在行的布局文件 –> R.layout.xxxx.xml;
- 搜索整个项目获取到R.layout.xxxx.xml文件;
- 通过该布局文件去遍历找出含有id的布局标签,当然如果考虑完善一点需要考虑include等等;
- 遍历完成后生成对话框,让用户可以自己选择需要生成注解的View以及点击事件,这个是Java GUI里面的内容
- 最后当用户点击确定生成最终的注解代码即可

  这么说起来还是挺简单的,当然其中的细节还是让人很蛋疼的,需要不断反复的调试。

2.2 具体实现

  • 获取光标所在行的布局文件 –> R.layout.xxxx.xml;
    /**
     * 获取当前光标的layout文件
     */
    private String getCurrentLayout(Editor editor) {
        Document document = editor.getDocument();
        CaretModel caretModel = editor.getCaretModel();
        int caretOffset = caretModel.getOffset();
        int lineNum = document.getLineNumber(caretOffset);
        int lineStartOffset = document.getLineStartOffset(lineNum);
        int lineEndOffset = document.getLineEndOffset(lineNum);
        // 获取当前光标所在行的所有内容
        String lineContent = document.getText(new TextRange(lineStartOffset, lineEndOffset));
        String layoutMatching = "R.layout.";
        if (!TextUtils.isEmpty(lineContent) && lineContent.contains(layoutMatching)) {
            // 获取layout文件的字符串
            int startPosition = lineContent.indexOf(layoutMatching) + layoutMatching.length();
            int endPosition = lineContent.indexOf(")", startPosition);
            String layoutStr = lineContent.substring(startPosition, endPosition);
            // 可能是另外一种情况 View.inflate
            if (layoutStr.contains(",")) {
                endPosition = lineContent.indexOf(",", startPosition);
                layoutStr = lineContent.substring(startPosition, endPosition);
            }
            return layoutStr;
        }
        return null;
    }
  • 搜索整个项目获取到R.layout.xxxx.xml文件;
 @Override
    public void actionPerformed(AnActionEvent e) {
        // 获取project
        Project project = e.getProject();
        // 获取选中内容
        final Editor mEditor = e.getData(PlatformDataKeys.EDITOR);
        if (null == mEditor) {
            return;
        }
        SelectionModel model = mEditor.getSelectionModel();
        mSelectedText = model.getSelectedText();
        // 未选中布局内容,显示dialog
        if (TextUtils.isEmpty(mSelectedText)) {
            // 获取光标所在位置的布局
            mSelectedText = getCurrentLayout(mEditor);
            if (TextUtils.isEmpty(mSelectedText)) {
                mSelectedText = Messages.showInputDialog(project, "布局内容:(不需要输入R.layout.)", "未选中布局内容,请输入layout文件名", Messages.getInformationIcon());
                if (TextUtils.isEmpty(mSelectedText)) {
                    Util.showPopupBalloon(mEditor, "未输入layout文件名", 5);
                    return;
                }
            }
        }
        // 获取布局文件,通过FilenameIndex.getFilesByName获取
        // GlobalSearchScope.allScope(project)搜索整个项目
        PsiFile[] psiFiles = FilenameIndex.getFilesByName(project, mSelectedText + ".xml", GlobalSearchScope.allScope(project));
        if (psiFiles.length <= 0) {
            Util.showPopupBalloon(mEditor, "未找到选中的布局文件" + mSelectedText, 5);
            return;
        }
        XmlFile xmlFile = (XmlFile) psiFiles[0];
        List<Element> elements = new ArrayList<>();
        Util.getIDsFromLayout(xmlFile, elements);
        // 将代码写入文件,不允许在主线程中进行实时的文件写入
        if (elements.size() != 0) {
            PsiFile psiFile = PsiUtilBase.getPsiFileInEditor(mEditor, project);
            PsiClass psiClass = Util.getTargetClass(mEditor, psiFile);
            // 有的话就创建变量和findViewById
            if (mDialog != null && mDialog.isShowing()) {
                mDialog.cancelDialog();
            }
            mDialog = new FindViewByIdDialog(mEditor, project, psiFile, psiClass, elements, mSelectedText);
            mDialog.showDialog();
        } else {
            Util.showPopupBalloon(mEditor, "未找到任何Id", 5);
        }
    }
  • 通过该布局文件去遍历找出含有id的布局标签,当然如果考虑完善一点需要考虑include等等;

    /**

    • 获取所有id
      *
    • @param file
    • @param elements
    • @return
      */
      public static java.util.List getIDsFromLayout(final PsiFile file, final java.util.List elements) {
      // To iterate over the elements in a file
      // 遍历一个文件的所有元素
      file.accept(new XmlRecursiveElementVisitor() {
      @Override
      public void visitElement(PsiElement element) {
      super.visitElement(element);
      // 解析Xml标签
      if (element instanceof XmlTag) {
      XmlTag tag = (XmlTag) element;
      // 获取Tag的名字(TextView)或者自定义
      String name = tag.getName();
      // 如果有include
      if (name.equalsIgnoreCase(“include”)) {
      // 获取布局
      XmlAttribute layout = tag.getAttribute(“layout”, null);
      // 获取project
      Project project = file.getProject();
      // 布局文件
      XmlFile include = null;
      PsiFile[] psiFiles = FilenameIndex.getFilesByName(project, getLayoutName(layout.getValue()) + “.xml”, GlobalSearchScope.allScope(project));
      if (psiFiles.length > 0) {
      include = (XmlFile) psiFiles[0];
      }
      if (include != null) {
      // 递归
      getIDsFromLayout(include, elements);
      return;
      }
      }
      // 获取id字段属性
      XmlAttribute id = tag.getAttribute(“android:id”, null);
      if (id == null) {
      return;
      }
      // 获取id的值
      String idValue = id.getValue();
      if (idValue == null) {
      return;
      }
      XmlAttribute aClass = tag.getAttribute(“class”, null);
      if (aClass != null) {
      name = aClass.getValue();
      }
      // 添加到list
      try {
      Element e = new Element(name, idValue, tag);
      elements.add(e);
      } catch (IllegalArgumentException e) {

              }
          }
      }
      

      });
      return elements;
      }

      • 遍历完成后生成对话框,让用户可以自己选择需要生成注解的View以及点击事件,这个是Java GUI里面的内容,我就大致黏贴一部分代码把,把对话框中间的部分黏贴出来,具体可以去github下载源码
    /**
     * 解析mElements,并添加到JPanel
     */
    private void initContentPanel() {
        mContentJPanel.removeAll();
        // 设置内容
        for (int i = 0; i < mElements.size(); i++) {
            Element mElement = mElements.get(i);
            IdBean itemJPanel = new IdBean(new GridLayout(1, 4, 10, 10),
                    new EmptyBorder(5, 10, 5, 10),
                    new JCheckBox(mElement.getName()),
                    new JLabel(mElement.getId()),
                    new JCheckBox(),
                    new JTextField(mElement.getFieldName()),
                    mElement);
            // 监听
            itemJPanel.setEnableActionListener(this);
            itemJPanel.setClickActionListener(clickCheckBox -> mElement.setIsCreateClickMethod(clickCheckBox.isSelected()));
            itemJPanel.setFieldFocusListener(fieldJTextField -> mElement.setFieldName(fieldJTextField.getText()));
            mContentJPanel.add(itemJPanel);
            mContentConstraints.fill = GridBagConstraints.HORIZONTAL;
            mContentConstraints.gridwidth = 0;
            mContentConstraints.gridx = 0;
            mContentConstraints.gridy = i;
            mContentConstraints.weightx = 1;
            mContentLayout.setConstraints(itemJPanel, mContentConstraints);
        }
        mContentJPanel.setLayout(mContentLayout);
        jScrollPane = new JBScrollPane(mContentJPanel);
        jScrollPane.revalidate();
        // 添加到JFrame
        getContentPane().add(jScrollPane, 1);
    }
  • 最后当用户点击确定生成最终的注解代码即可,主要生成两部分代码@ViewById(R.id.xxx) , @OnClick(R.id.xxx)即可
    /**
     * 创建注解View变量
     */
    private void generateFields() {
        for (Element element : mElements) {
            if (mClass.getText().contains("@ViewById(" + element.getFullID() + ")")) {
                // 不创建新的变量
                continue;
            }
            // 设置变量名,获取text里面的内容
            String text = element.getXml().getAttributeValue("android:text");
            if (TextUtils.isEmpty(text)) {
                // 如果是text为空,则获取hint里面的内容
                text = element.getXml().getAttributeValue("android:hint");
            }
            // 如果是@string/app_name类似
            if (!TextUtils.isEmpty(text) && text.contains("@string/")) {
                text = text.replace("@string/", "");
                // 获取strings.xml
                PsiFile[] psiFiles = FilenameIndex.getFilesByName(mProject, "strings.xml", GlobalSearchScope.allScope(mProject));
                if (psiFiles.length > 0) {
                    for (PsiFile psiFile : psiFiles) {
                        // 获取src\main\res\values下面的strings.xml文件
                        String dirName = psiFile.getParent().toString();
                        if (dirName.contains("src\\main\\res\\values")) {
                            text = Util.getTextFromStringsXml(psiFile, text);
                        }
                    }
                }
            }

            StringBuilder fromText = new StringBuilder();
            if (!TextUtils.isEmpty(text)) {
                fromText.append("/****" + text + "****/\n");
            }
            fromText.append("@ViewById(" + element.getFullID() + ")\n");
            fromText.append("private ");
            fromText.append(element.getName());
            fromText.append(" ");
            fromText.append(element.getFieldName());
            fromText.append(";");
            // 创建点击方法
            if (element.isCreateFiled()) {
                // 添加到class
                mClass.add(mFactory.createFieldFromText(fromText.toString(), mClass));
            }
        }
    }

    /**
     * 创建OnClick方法
     */
    private void generateOnClickMethod() {
        for (Element element : mElements) {
            // 可以使用并且可以点击
            if (element.isCreateClickMethod()) {
                // 需要创建OnClick方法
                String methodName = getClickMethodName(element) + "Click";
                PsiMethod[] onClickMethods = mClass.findMethodsByName(methodName, true);
                boolean clickMethodExist = onClickMethods.length > 0;
                if (!clickMethodExist) {
                    // 创建点击方法
                    createClickMethod(methodName, element);
                }
            }
        }
    }

    /**
     * 创建一个点击事件
     */
    private void createClickMethod(String methodName, Element element) {
        // 拼接方法的字符串
        StringBuilder methodBuilder = new StringBuilder();
        methodBuilder.append("@OnClick(" + element.getFullID() + ")\n");
        methodBuilder.append("private void " + methodName + "(" + element.getName() + " " + getClickMethodName(element) + "){");
        methodBuilder.append("\n}");
        // 创建OnClick方法
        mClass.add(mFactory.createMethodFromText(methodBuilder.toString(), mClass));
    }

    /**
     * 获取点击方法的名称
     */
    public String getClickMethodName(Element element) {
        String[] names = element.getId().split("_");
        // aaBbCc
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < names.length; i++) {
            if (i == 0) {
                sb.append(names[i]);
            } else {
                sb.append(Util.firstToUpperCase(names[i]));
            }
        }
        return sb.toString();
    }

  如果在公司的时候比较闲像我一样,那么还是可以去了解一下插件开发的,我们可以利用它去生成代码或者修改代码找没有用到的资源等等等等,还是蛮不错的,如果是天天加班还是应该考虑一下学习成本,因为有些地方刚接触还是容易蒙B。

附上源码地址:https://github.com/Shenmowen/DarrenIOC

所有分享大纲:2017Android进阶之路与你同行

视频讲解地址:周六晚上八点

下一期我们会讲解 模板设计模式构建整个应用的BaseActivity

双鱼林基于安卓Android代码生成器是一款生成安卓手机程序的代码生成器 基于分层模式设计思想,生成的代码直接导入Eclipse软件就可以用的!   真正面向对象设计:系统的整体设计,提供通过使用面向对象的方法,设计所需系统中的基础对象(类),并根据专业级的“三层架构模板”生成专业级的界面和源代码,同时设计系统和数据库:采用“数据映射”建立基础对象(类)与数据表之间的关系,在设计类的同时,就可以完成关联表结构的设计!   轻松解决多表关联:多表关联一直是一个繁琐的问题,如一个员工属于一个部门。在设计基础对象(类)时,可以将部门类(不是部门编号)作为员工类的一个属性,自动生成表间关联代码,在界面上也可以实现部门名称的显示,及使用下拉框选择部门   系统实现了字符串,整数,小数,日期类型,图片类型这些常见类型的CRUD操作,并且实现了对象之间的外键关联!手机客户端主要包括了以下目录结构代码的自动生成:  com.mobileclient.activity:充当界面层(界面描述在布局文件中)和控制层(控制程序的运行流程)。 com.mobileclient.domain:实体对象描述层,负责描述和封装对象的各个属性,在各个层次中进行数据流动。 com.mobileclient.service:业务逻辑层,通过和服务器通信,实现数据的发送和接收。 com.mobileclient.handler:当服务器返回xml数据集时,需要调用这个层的类实现xml数据集到java对象数据链表的转换,这里采用的是SAX解析技术,相比DOM技术解析需要更低内存,很适合手机上使用。 com.mobileclient.util:里面包括各种Adapter主要负责将各种数据渲染显示到界面上,这里还有个ImageService负责从服务器获取图片资源,HttpUtil负责和服务器通信,主要是发送参数给服务器! com.mobileclient.app:保存应用程序类,全局变量可以放到这里,应用程序中未处理的异常可以在此被捕获到日志文件。 res/layout:各种界面布局文件! res/drawable-mdpi:程序界面中用到的图片资源文件!
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值