分类： Codes

1. Exceljs是什么？

Exceljs作为开源免费功能强大的JS库，受到了广大开发人员的好评。开源地址为https://github.com/exceljs/exceljs

通过这个lib我们可以使用Javascript轻松的生成/操纵/读取Excel文件。

1.1 如何获得Exceljs文件

官方渠道没有提供现成的CDN或者直接可下载的js lib文件。根据官方文档，需要使用npm install命令来获得exceljs文件。

npm install exceljs

执行完该命令后，会在当前目录下生成node js project，所以建议先新建一个文件夹，然后命令行切换到改文件夹之后再执行此命令。

然后进入下列位置：
XXXXXX（当前文件夹名称）-> node_modules -> exceljs -> dist
拷贝出exceljs.min.js与exceljs.min.js.map文件。

新建文件夹exceljslib，并将上述两个文件放入。

压缩该文件夹为exceljslib.zip备用。

1.2 当然，如果你手懒的话我可以提供打包好的版本

点击下载（如果信任我的话）：exceljslib.zip

2. Salesforce端

2.1 将exceljslib.zip上传至static resouce：

Setup-> Custom Code->Static Resouces->New->Name:exceljs->File:exceljslib.zip

2.2 LWC中引用ExcelJS

在环境中创建LWC【TestExcelJS】，根据需要，参考下面代码，结合官方文档填充操纵excel部分代码。

import { LightningElement, api } from 'lwc';
// 加载Static Resource必须先引入loadScript
import { loadScript } from 'lightning/platformResourceLoader';
// 引入staticResource并且命名为exceljs，这里喜欢的话叫它zhangsan也可以
import exceljs from '@salesforce/resourceUrl/exceljs';

export default class TestExcelJS extends LightningElement {
    @api async download() {
        try{
            // 不加入下面两行引用exceljs会报错，具体原理以后会专门开一篇文章讲解
            var regeneratorRuntime = undefined;
            window.regeneratorRuntime = regeneratorRuntime;
            // loadScript路径规则=> / import的staticResource名 / zip包名 / 文件夹名 / js文件名
            await loadScript(this, exceljs + '/exceljslib/exceljs.min.js');
            // 创建ExcelJS实例
            const workbook = new ExcelJS.Workbook();
            // 此处参照官方文档对excel进行操作
            // ......
            // 比如添加一个sheet页
            // const sheet1 = workbook.addWorksheet("Sheet1");
            // 之后用前端页面或者后台查询的数据填充该sheet页等。

            // 下载生成的workbook
            const buffer = await workbook.xlsx.writeBuffer();
            const blob = new Blob([buffer], { type: 'application/octet-stream' });
            const link = document.createElement('a');
            link.href = window.URL.createObjectURL(blob);
            link.download = 'MyData.xlsx';
            link.click();  
        } catch (error) {
            console.error(error);
        }
    }
}

在LWC的HTML中随便创建一个可点击的button

<template>
    <button onclick={download}><b>Click to Export!</b></button>
</template>

点击后，就可以得到想要的Excel文件。

某天，旁边的同事自顾自地嘀咕起来：“如果Trigger里也能用Return该多好啊。。。。”。
我一听这话忍不了啊，使劲儿拍了下他的桌子，“能啊！谁说不能的！”

Trigger中使用Return规则遵从代码块作用域规则。
举个例子，

（注：Return;皆加在Debug Log之前）
如果在位置0写Return;
那么整个Trigger都会被Return跳过去，Debug Log中没有任何输出。
如果在位置1写Return;
那么第一个handler中的内容都会被跳过，Debug Log的输出结果为0,4,5,6。
如果在位置2写Return;
那么第一个handler的第一个方法的内容都会被跳过，Debug Log的输出结果为0,1,3,4,5,6。
同理，如果在位置4写Return;
那么第二个handler被完整跳过，Debug Log的输出结果为0,1,2,3。
通俗的讲，就是从方法级别开始，只影响到花括号范围。

那么有同学肯定会问。虽然代码规范一般不允许一个sObject建多个Trigger。那么万一就是有两个Trigger呢。
然后在其中一个Trigger中使用Return，会影响另一个Trigger执行吗？

答案是：不会。

道理是一样的，把Trigger降级一层，外面再加一层运行环境，那么每个Trigger里的Return就如同Handler里的Return，也只能影响自己而已。

// Update
自从某次Release之后，如果Return; 语句后面还有可执行的语句，保存时会报错，说有unreachable的代码。
如果想做实验，需要使用如下写法

if(true) {
    return;
}

在Spring’17，Salesforce为开发者提供了一个强大的工具，Apex STUB API。

看完官方文档提供的例子之后，感觉确实很美好，但又觉得没什么机会用。
不同于Java项目对框架和设计模式的极致追求。
我接手的Apex代码均为意识流散文诗式写法。根本没有抽象化，解耦等操作。

Stub Api是基于Java的Mocking Framework
mockito开发的。
使用Mocking Framework的前提是代码必须进行解耦，就是所谓的依赖注入（Dependency Injection）。
要求代码不能按业务直接写成流水账，而是将模块之间的强依赖解开。

比如，A类的构造强依赖与B类，如果没有B则没有A。

A a = new A();
//-----------------------------------
Class A {
    private B b;
    public A() {
        b = new B();
    }
    public String getName() {
        return b.getName();
    }
}

Class B {
   public String getName() {
       return "I'm the B";
   }
}

那么，问题来了，如果我有一个C类，返回“I’m the C”，我就要为C类新建一个A1类，在A1类中将A1与C进行强依赖。
如果需求越来越多，代码也随时越来越膨胀。
那么怎么改变这个局面呢？

B b = new B();
A a = new A(b);
-----------------------------------------------
Class A {
    private CustomObject co;
    public A(CustomObject cObj) {
        this.co = cObj;
    }
    public String getName() {
        reutrn co.Name;
    }
}

Class B extends CustomObject {
    public String getName() {
        return "I'm the B";
    }
}
abstract Class CustomObject {
    abstract public String getName();
}

这样一来，A和B的强依赖就解耦了，不再是每次new一个A，就必然得到B的内容，而是根据我传进去的B来决定A返回的内容。
如果想返回“I’m the C”，就不用再去新建一个A1类，想返回“I’m the D”，不用再去新建一个A2类。

只有依赖注入的写法才能进行方便的Mocking。

Stub Api可以做到的是，在解耦之后，为A类mock一个B类，C类。做到完美的单元测试（模块隔离）。
Whatever，用不上。至今还没见到过有控制反转思想的的Apex。
说句题外话，apex-enterprise-patterns(官方介绍文章)到现在还没推广开呢。

// 未完待续

先放Github地址
https://github.com/Kealthals/Salesforce-StandardSetControllerDemo.git

事情起因，是有人问我为什么StandardSetController无法保存Selected状态。
我觉得既然标准List View可以，那么使用StandardSetController应该也可以。
虽然这个Class我用的也不多，但还是动手写个一个小Demo验证了一下我的想法，虽然花了些小心思，但证明确实可行。
验证完毕，转念一想，既然已经动手了，就干脆把所有的methods都演示一遍吧。权当给自己留一个财富。

StandardController大家都比较熟悉，用来处理单条数据。模拟的是Create/Edit页面和Detail页面。
StandardSetController用的不多，因为模拟的是List View页面。标准List View页面已经很强大了，很少会遇到这种需求。
这个Demo也就是尽量做一个和标准List View类似的页面，时间有限，肯定做不到标准页面一般的好看和完美。
最低目标是将这个Class提供的method都使用一遍，除了一个不明所以的method之外，最低目标我觉得是完成了。
功能上，也提供了基本的
1. 罗列数据
2. 翻页
3. 选择数据(Selected)
4. 选择List View
5. 改变Page Size
6. 跳转指定页
7. Inline Edit(还不完美)
作为一个独立功能来讲，勉强达到了凑合着用的程度。
在功能实现的时候，又不断遇到了一些或新或旧的小问题，在大家的帮助下都找了比较好的小方案解决掉了这些小问题。
比如SFDC的autofocus，inputtext的输入类型限制等等。

继续阅读“Salesforce的StandardSetController使用Demo”

How to remove VF input field’s autofocus?
最近在写StandardSetController Demo的时候遇到了一个逼死完美主义者的问题。
在VF加载之后，SFDC会非常Nice的，热心的，把第一个文本输入框设为焦点。
我推测sfdc的产品设计逻辑是下面这样的。
嗯。。。你设置一个输入框，代表着用户一定得输入点什么才能继续。
既然用户必须输入点什么的话，那么就必须用鼠标点一下这个输入框。
那么让我们来做点什么吧，帮用户先把输入框点上怎么样，节省用户的操作。
看呐，如果用户双手都在键盘上，他们连右手离开键盘的工夫都省下来了，用户一定会非常满意的。

对于大部分业务场景，这个贴心的小设计确实很有用。但有的时候会起反作用。
比如我的StandardSetController的Demo。
在List View画面，一般只有在数据列表最下方才有输入框，为了输入Page Size或者Page No。
但是不碰这几个输入框并不影响我使用List View。
不过，当默认Page Size非常大，画面超出一屏的时候，由于sfdc自动把第一个输入框设成焦点，导致画面滚动条直接被拖到了滚动条最下面。
还有当VF的第一个input项目是Date型的时候，sfdc的自动设置焦点机制，会触发datepicker，就像大晴天自动弹开的雨伞一样，造成另一场灾难。

研究了半天，虽然标准List View并没有这个问题，但还是没有找到比较官方的解决方法。
只好Hack一下了。

在VF中插入

   <script>
        function setFocusOnLoad() {}
    </script>

问题完美解决。