macOS 10.14.2
JDK 1.8
java -jar MarkdownEditor.jar
java -jar server.jarjar 文件见浙大网盘https://pan.zju.edu.cn/share/042430c2139903215cf1ba2ee5，如不能打开请邮件联系作者。
- diff-match-patch: https://github.com/google/diff-match-patch
- flexmark-java: https://github.com/vsch/flexmark-java
Id 指明了要加入/创建的协作组。
Client 整个架构是 MVC 架构，中心的 Controller 负责协调 View 与 Model 进行消息传递。
controller 包内部分为 Controller 、Connector 、MarkdownParser 三部分。
其中 Controller 控制总的流程，而 Connector 则负责与 Server 通过 Socket 进行信息交互，包括接收和发送信息。Connector 负责解析 markdown 格式为 html 格式，这个类负责把外部库的 API 进行封装，将内部代码与第三方库解耦合，方便后续扩展。
Connector 使用了第二个线程来进行 Socket 监听，当读到来自 server 的消息时，根据消息类型进行发送给 Controller 处理。
建立 Socket 传输关系的主要方法如下：
Socket socket = new Socket(ip, port);
ObjectOutputStream toServerStream = new ObjectOutputStream(socket.getOutputStream());
ObjectInputStream fromServerStream = new ObjectInputStream(socket.getInputStream());接着就可以通过 fromServerStream 和 toServerStream 读写消息。
MarkdownParser 使用第三方库 flexmark 来用于将 markdown 解析为 html 格式。
将 markdown 格式解析出标题使用的是 JDK 1.8 的正则表达式功能。如解析第5级标题的正则表达式是：
Pattern.compile("(?m)^#{5}(?!#)(.*)")
View 部分即为窗口组件，GUI 使用 Java Swing 来进行编程。
顶栏使用了 JMenuBar ，其中包含了组件 JMenu 与 JMenuItem ，使用 add() 方法可以将其绑定。
例如：
menuBar.add(menu);
menu.add(menuItem);左栏使用了 JList 来显示大纲，Jlist 绑定了 DefaultListModel ，将大纲信息存储在 DefaultListModel 中，一旦大纲信息改变，Jlist 会自动更新。使用缩进来表示大纲的层级。
outlineList = new JList<>(listModel);写作的窗口使用了 JTextArea ，使用 DocumentListener 来监听事件。
editorArea.getDocument().addDocumentListener(documentListener)
private DocumentListener documentListener = new DocumentListener() {
@Override
public void insertUpdate(DocumentEvent e) {...}
@Override
public void removeUpdate(DocumentEvent e) {...}
@Override
public void changedUpdate(DocumentEvent e) {...}
};JList 和 JTextArea 都包了一层 JScrollPane 用于产生可以滚动的界面。
例如：
JScrollPane editorPane = new JScrollPane(editorArea);
文件选择器使用 JFileChooser 实现，可以使用 FileNameExtensionFilter 来添加类型过滤器。
Model 中存储了用于更新侧边大纲的数据 DefaultListModel<String> 。
Server 维护了一个存储 Session 的 HashMap ，每个 Session 负责一组协作者。
class Server {
private static final int PORT = 12345;
private SessionCollection sessionCollection = new SessionCollection();
private ExecutorService threadPool = Executors.newCachedThreadPool();
...
}每个 Session 也使用一个 Map 来存储 Client ，并且用一个 String 来存储公共的 markdown 文件。
class Session {
private Map<Integer, WriteSignal> writeSignalMap = Collections.synchronizedMap(new HashMap<>());
private String text;
...
}Server 端使用 Java 的线程池来创建线程与客户端进行信息传递。
ExecutorService threadPool = Executors.newCachedThreadPool();每个客户端都对应了 read 和 write 两个线程，分别用于读写数据。
当读线程读到一个传递文本的数据包时，读线程通知 Session 使用 TextMerger 来将数据包中的文本与 Session 中的文本进行比较合并冲突，并更新 Session 中的文本，并通知 Session 中所有的 Client （除了自己所在的 Client）更新自己的文本。
通知更新客户端的文本是通过向 write 线程发消息完成的，接收到消息后 write 线程将文本装包发送给客户端。当 Client 收到数据包时判断类型，如果是 PacketType.TEXT 类型，那么就更新文本；如果是 PacketType.REPLY 类型，就使用 JOptionPane.showMessageDialog() 来通过消息窗口显示消息。
Server 端的消息通信通过共享 WriteSignal 类型的数据来完成，其中含有条件变量等用于同步、消息传递的数据结构。
class WriteSignal {
private int idInSession;
private final AtomicReference<Packet> packet = new AtomicReference<>();
private final AtomicBoolean continueRun = new AtomicBoolean(true);
private Lock lock = new ReentrantLock();
private Condition condition = lock.newCondition();
...
}使用 Packet 来作为 Server 与 Client 之间的数据传递的数据结构。
class Packet implements Serializable {
private PacketType packetType;
private String text;
....
}其中，Packet 中存储了 packetType 来指明数据包的类型：
public static enum PacketType {
//join a cooperation editing
JOIN,
//establish a cooperation editing
ESTABLISH,
//normal text packet
TEXT,
//close connection
CLOSE,
//reply message
REPLY
}将 Packet 实例序列化后即可通过 Socket 进行传输。