设计方案

PostRepositoryByList和PostRepositoryByMap都已经实现了博客管理的部分功能，现在还差几个重要部分：

• 创建博客（输入标题与内容）
• 实现博客信息的文件存储
• 从文件中加载所有博客信息

那应该如何来存储呢？ 这里我们给出一种方案：

• 一篇博客存储为一个文本文件
• 文件的名称以 {id}---{title}进行命名，比如id为1、标题为"天码营"的文章，用以保存内容的文件就命名为1---天码营
• 文件的内容就是博客的内容，即content属性
• 将所有文本文件保存在当前文件夹中命名为TMY-BLOG的文件夹中

我们以PostRepositoryByList为例来讲如何实现完整的功能。

基于以上的方案，首先我们可以使用static和final修饰符来定义两个常量：

public class PostRepositoryByList implements PostRepository {

    private static final String FOLDER = "TMY-BLOG"; // 保存文件的文件夹名称
    private static final String SEPARATOR = "---"; // id和title的分隔符

    ...
}

引入第三方的库

Java开发中最经常做的一件事情就是管理项目的依赖，所谓的依赖其实就是第三方的库，以JAR包的形式存在。JAR包就是把编译好的类用Zip格式压缩存储在一个文件中。引入JAR包，我们就能够使用JAR包公共的类及其方法和属性。

Java开发中大多数常用的功能其实都有非常优秀的第三方库实现了，给我们提供了很多“轮子”，我们造汽车的时候直接拿来就可以了。

我们现在需要进行文件操作，这里我们准备使用Apache Commons IO提供的一个文件操作库来实现博客信息的加载和存储。

当然我们也可以使用JDK自带的IO功能来实现，不过你需要学习Java IO相关的类和接口，还记得我说的三个神器吗？大家可以自行学习。这些类和接口通常也称之为API，应用编程接口，它们给我们提供的一些封装了底层功能的基础设施，极大地简化了我们的开发。事实上了解API可能是成为一个编程高手花时间最多的一个地方。当然你也不可能把所有API完全记下来。在软件开发中也有二八原则，少数的API能够胜任开发中的大部分场景。所以你只需要掌握这些关键部分，当在新场景下遇到不能解决的新问题时，再去查看帮助文档。所以帮助文档的阅读也是技术学习的一个关键因素。了解了基础原理之后一般就能上手开发了，帮助文档可以帮助你在实践中学习。

回到我们的项目，要使用第三方的库，需要将其加入到类路径当中。

• 到Apache Commmons IO官方网站下载最新的库，现在的版本是2.4。
• 解压之后，找到commons-io-2.4.jar，在项目中新建一个文件夹，命名为lib，将该文件拷贝进入lib文件夹。
• 在Eclipse中右键点击该文件，【Build Path】->【Add to Build Path】就将这个JAR包加入到类路径当中了。只需要在代码中，进行import就能使用其中的类了。

将来我们引入其他JAR包也可以按照相同的方式来进行操作。

单例模式

PostRepositoryByList的方法操作的都是static类型的List，即所有实例共享数据，因此一个PostRepositoryByList实例（即对象）就能满足使用了。为了让系统更加高效，应该让用户无法创建多个PostRepositoryByList实例。

让一个类只能创建一个实例的做法，是一种典型的设计模式，成为Singleton模式。设计模式你可能还是第一次听说，你现在只要知道设计模式是一种常用的定义类的方式就好了，这些方式能更好地适应某些特定的应用场景。

为了实现Singleton模式，我们对PostRepositoryByList做两点修改：

1. 将构造函数定义为private的，这样外部就不能创建PostRepositoryByList实例了；
2. 外部既然无法创建，那怎么使用呢？ PostRepositoryByList可以提供一个获取实例的静态方法，每次返回的都是它自己创建的唯一一个实例。

public class PostRepositoryByList implements PostRepository {
   
    ...
    
    private static final PostRepository postRepository = new PostRepositoryByList();           
    
    public static PostRepository instance() {
        return postRepository;
    }
    
    private PostRepositoryByList() {
    }
    ...
}

做了这两点修改后，系统中就只可能出现唯一一个PostRepositoryByList实例了。你已经学会了第一个设计模式了！

处理命令行输入

接下来我们来设计创建博客的流程：

1. 如果输入命令为create，则表示开始创建博客，输出提示信息“please input blog title"；
2. 输入一行信息，这一行是博客的标题；
3. 继续输入信息，可以是多行信息，如果某一行的内容为":wq"，则表示内容输入完成；
4. 输入完成后创建Post对象，添加到PostRepository中。

为了实现这个流程，代码中有几个关键点：

• 我们可以使用while循环来不断获取输入，当发现结束信息时跳出循环。
• 为了获取一行输入，可以调用Scanner的nextLine()方法。
• 将一行行的信息拼接成为一个完整的字符串，可以使用StringBuffer。
• 得到title和content的信息后，调用Post构造函数即可创建对象。

以下为处理create命令的代码：

private static void processCreateCommand() {
    System.out.println("please input blog title");
    String title = scanner.nextLine();
    System.out.println("please input blog content ended with '***'");

    StringBuffer content = new StringBuffer();

    while (true) {

        String word = scanner.nextLine();

        if (word.equals(END_OF_POST)) {
            break;
        }

        content.append(word);
        content.append("\n");
    }

    Post post = new Post(title, content.toString());
    post.print();
    postRepository.add(post);
}

从文件加载博客信息

从博客加载信息的流程为：

1. 读取TMY-BLOG文件夹下的所有文件；
2. 遍历每一个文件，从文件名中解析出id和title，读取文件内容作为content；
3. 根据读取的信息创建Post对象，并且添加到PostRepository中。

代码实现中，有以下几个关键点：

• 获取一个文件夹下的所有文件可以调用Commons-IO库中FiltUtils类的listFiles方法。你可能会问如何知道需要调用这个方法，首先是可以去读它的文档，或者你在Google中输入"Commons IO"、"read all files in a directory"等关键字，你肯定能找到解决方案。
• 将文件名拆分为id和title两部分，可以调用String类的split方法。你可以思考一个问题，如果标题中也包含"---"这几个字符会出现什么情况，你应该如何解决？
• 将字符串转换成long类型的id，可以通过Long.parseLong()方法。
• 这里你需要处理两种异常，一种是FitleUtils的readFileToString()方法可能抛出的IOException，Eclipse会给你自动提示。第二种是Long.parseLong()方法如果遇到一个不是表达整数的字符串，可能抛出NumberFormatException。我们要确保异常情况下程序不会意外退出。如何catch多个异常现在你应该知道怎么做了吧？

@Override
public void loadData() throws BlogAppException {
  File dir = new File(FOLDER);
  List<File> files = (List<File>) FileUtils.listFiles(dir, null, true);
 
  for (File f : files) {

      try {
          String fileName[] = f.getName().split("---");
          String content = FileUtils.readFileToString(f, "utf-8");

          Post post = new Post(fileName[1], content);
          post.setId(Long.parseLong(fileName[0]));
          
          postRepository.add(post);

      } catch (IOException e) {
          e.printStackTrace();
          BlogAppException be = new BlogAppException("load");
          be.initCause(e);
          throw be;
      } catch (NumberFormatException e) {
          e.printStackTrace();
          BlogAppException be = new BlogAppException("load");
          be.initCause(e);
          throw be;
      } 
  }        
}

这里我们将catch到的异常，重新以BlogAppException的方式抛出来，交给main方法来处理。这样情况下，为了保存导致某个异常的原因（即另一个异常），可以调用initCause()方法。这样就不会丢失异常信息，能够方便我们进行调试和异常处理。

将博客信息保存文件

将博客信息保存的文件的流程与加载流程刚好相反，这里我们需要基于博客信息生成文件的标题和内容，代码如下：

@Override
public void saveData() throws BlogAppException {
    for (Post post : PostRepositoryByList.instance().getAll()) {
        String fileName = Long.toString(post.getId()) + SEPARATOR
                + post.getTitle();
        try {
            FileUtils.write(new File(FOLDER + File.separator + fileName), post.getContent());
        } catch (IOException e) {
            e.printStackTrace();
            BlogAppException be = new BlogAppException("save");
            be.initCause(e);
            throw be;
        }
    }        
}

至此，我们的博客管理应用已经完成了。虽然是一个很简陋的应用，但是我们需要用到Java开发中的大部分核心知识，如果你已经可以轻松地写出这个应用，那么你现在可以进阶了！

你尝试继续学习Java贪吃蛇游戏的设计与实现，进一步巩固J2SE的编程技能。