Spring Boot CLI（Command Line Interface）是一个命令行工具，可用于快速搭建基于Spring的原型。它支持运行Groovy 脚本，这也就意味着你可以使用类似Java的语法，但不用写很多的模板代码。 Spring Boot 不一定非要配合 CLI 使用，但它绝对是让 Spring 应用进入状态的最快方式。 手动安装 你可以从 Spring 的软件仓库中下载 Spring CLI 分发包： spring-boot-cli-2.1.0.RELEASE-bin.zip spring-boot-cli-2.1.0.RELEASE-bin.tar.gz 更前沿和更新的 snapshot distributions 也是可以下载到的。 一旦你下载完成后，请按照 INSTALL.txt 中的指南来解压归档文件。主要来说，这里有一个 spring 脚本（spring.bat 是针对 Windows 使用的）在 bin/ 目录下的 .zip 文件中。可选的，你可以使用 java -jar 再加上 .jar 文件（脚本文件能够帮助你确保 classpath 已经正确的设置了）。 使用 SDKMAN! 进行安装 SDKMAN! (The Software Development Kit Manager) 中文可以翻译为软件开发管理工具可以被用来管理多个版本的 2 进制 SDKs，包括 Groovy 和Spring Boot CLI。你可以从 sdkman.io 网站上来获得 SDKMAN!，然后通过使用下面的命令行工具来安装 Spring Boot： $ sdk install springboot $ spring --version Spring Boot v2.1.0.RELEASE 如果你正在为CLI开发新的特性，并想轻松获取刚构建的版本，可以使用以下命令： $ sdk install springboot dev /path/to/spring-boot/spring-boot-cli/target/spring-boot-cli-2.1.0.RELEASE-bin/spring-2.1.0.RELEASE/ $ sdk default springboot dev $ spring --version Spring CLI v2.1.0.RELEASE 前面的安装指南将会安装一个被称为 dev 的 spring 安装实例。 它指向你的目标构建位置，所以每次你重构 Spring Boot，spring 都会更新为最新的。 你可以通过下面的命令来查看到： $ sdk ls springboot ================================================================================ Available Springboot Versions ================================================================================ > + dev * 2.1.0.RELEASE ================================================================================ + - local version * - installed > - currently in use ================================================================================ OSX Homebrew 安装 如果你使用的是 Mac 同时使用 Homebrew，你可以通过使用下面的 Spring Boot CLI 来进行安装： $ brew tap pivotal/tap $ brew install springboot Homebrew 将会把 spring 安装到 /usr/local/bin 目录下 如果上面的命令不能安装到你的机器上，那么有可能是因为你的 brew 版本太老了。你只需执行 brew update 并重试即可。 MacPorts 安装 如果你使用的是 Mac 同时使用 MacPorts，你可以通过使用下面的 Spring Boot CLI 来进行安装： $ sudo port install spring-boot-cli 命令行实现 SpringBoot CLI 包含的脚本为 BASH 和 zsh shell 提供了实现。你可以在任何 shell，你的个人或系统的 bash 中 source 脚本（同时也命名为 spring）来完成初始化。在 Debian 系统中，全系统脚本在 /shell-completion/bash 或者当新的shell启动时该目录下的所有脚本都会被执行。例如，如果想要手动运行脚本，假如你已经安装了SDKMAN，可以使用以下命令： $ . ~/.sdkman/candidates/springboot/current/shell-completion/bash/spring $ spring <HIT TAB HERE> grab help jar run test version 如果你是通过使用 Homebrew 或 MacPorts 安装 Spring Boot CLI 的话，命令行工具将会自动在你的 shell 中注册。 Windows Scoop 安装 如果你使用的是 Windows 同时使用e Scoop，你可以通过使用下面的 Spring Boot CLI 来进行安装： > scoop bucket add extras > scoop install springboot Scoop 将会把脚本安装到 ~/scoop/apps/springboot/current/bin。 如果你没看到 app 的 manifest，那么有可能是你的额 scoop 安装已经过时了，请运行 scoop update 命令后再次尝试。 快速启动 Spring CLI 示例 你可以使用下面的 Web 应用来测试你的安装。为了启动，创建一个文件为 app.groovy，然后将下面的内容保存到这个文件中： @RestController class ThisWillActuallyRun { @RequestMapping("/") String home() { "Hello World!" } } 然后从 shell 中运行，使用下面的命令： $ spring run app.groovy 第一次运行的时候可能会比较慢，因为程序需要下载需要的依赖，在后续的运行中就会更加快速了。 在你的浏览器中输访问下面的 URL localhost:8080，你应该能够看到在浏览器中显示下面的内容： Hello World! https://www.cwiki.us/display/SpringBootZH/Installing+Spring+Boot
Spring Boot 可以使用经典的开发工具或者使用安装的命令行工具。不管使用何种方式，你都需要确定你的 Java 版本为 Java SDK v1.8 或者更高的版本。在你开始安装之前，你需要确定你当前安装的 Java 版本满足系统运行的需要。 你可以使用下面的命令进行查看： $ java -version 如果你是 Java 项目开发的新手或者你希望实践使用 Spring Boot。你应该使用 Spring Boot 命令行工具（Spring Boot CLI），否则的话，请阅读有关经典安装指南。 针对 Java 开发人员的安装指南 对于Java 开发者来说，使用 Spring Boot 就跟使用其他 Java 库一样，只需要在你的 classpath 下引入适当的 spring-boot-*.jar 文件。 Spring Boot不需要集成任何特殊的工具，所以你可以使用任何IDE或文本编辑器；同时，Spring Boot应用也没有什么特殊之处，你可以像对待其他Java程序那样运行，调试它。 尽管可以拷贝 Spring Boot jars，但我们还是更加建议你使用支持依赖管理的构建工具，比如 Maven 或 Gradle。 Maven 安装 Spring Boot 兼容 Apache Maven 3.3 或更高版本。如果本地没有安装Maven，你可以参考 maven.apache.org 上的指南在你本地安装 Maven。 在很多操作系统中，Maven 可以通过包管理器进行安装。如果你使用 OSX Homebrew 操作系统，你可以考虑使用 brwe 安装 Maven。 在 Ubuntu 中，你可以运行 sudo apt-get install 命令来安装 Maven。 Windows 用户，如果你使用了 Chocolatey ，你可以从弹出的管理员控制台中运行 choco install maven 命令。 Spring Boot依赖使用的 groupId 为 org.springframework.boot。 通常，你的 Maven POM 文件会继承 spring-boot-starter-parent 工程，并声明一个或多个 Starters 依赖。此外，Spring Boot提供了一个可选的 Maven 插件，用于创建可执行的 jars。 下面的 XML 文件中显示了一个常用的 pom.xml 文件。 <?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.example</groupId> <artifactId>myproject</artifactId> <version>0.0.1-SNAPSHOT</version> <!-- Inherit defaults from Spring Boot --> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.1.0.RELEASE</version> </parent> <!-- Add typical dependencies for a web application --> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> </dependencies> <!-- Package as an executable jar --> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project> 通常来说 spring-boot-starter-parent 是使用 Spring Boot 的一种不错的方式，但它可能并不总是最合适的。有时你可能需要继承一个不同的父 POM，或者不喜欢我们的默认配置。 在这种情况下，你可以使用 import 作用域（import scope）来替代默认的父 POM 继承，具体请查看：这种替代方案，具体查看 Section 13.2.2, “Using Spring Boot without the Parent POM” 页面中的内容。 Gradle 安装 Spring Boot 现在能够兼容 Gradle 4.4 及其后续版本。如果你的系统中还没有安装 Gradle， 你可以参考 gradle.org 页面中的内容。 Spring Boot 的依赖可通过 groupId 为 org.springframework.boot 来进行声明。通常，你的项目将声明一个或多个 “Starters” 依赖。Spring Boot 同时还提供了一个有用的 Gradle plugin 插件。这个插件通常可以用来简化依赖声明和创建可以执行的 jars。 Gradle Wrapper 当你需要构建项目时，Gradle Wrapper提供一种有效的获取 Gradle 的方式。它是一小段脚本和库，跟你的代码一块提交，用于启动构建进程，具体参考页面 docs.gradle.org/4.2.1/userguide/gradle_wrapper.html 中的内容。 更多有关开始使用 Spring Boot 和 Gradle 的细节可以在 Getting Started section 页面中的 Gradle 插件参考指南中找到。 https://www.cwiki.us/display/SpringBootZH/Installing+Spring+Boot
如果你已经为你的整个 Confluence 站点设置了特定主题（例如文档或者其他第三方的主题），你创建的空间将会集成你需要主题。如果你没有使用默认主题的话，你可能不能在边栏中看见蓝图。 Confluence 管理员可以禁用一个空间蓝图 - 请查看 管理站点模板 页面中的内容。 空间不能被集成（你不能在空间中集成另外一个空间），但是你可以使用 Use Labels to Categorise Spaces 对空间进行分类。 你可以导出整个空间，或者空间的一部分为 PDF, HTML 或 XML。 如果你需要修改，或者你的空间内容膨胀得过大，你可以非常容易的在空间之间 copy 或者 move 内容。 如果你空间的内容或者目的有了修改和变化，你可以更新 space name, logo, colors and description 而不会影响空间中的内容。 如果你不在需要一个空间，比如说你的项目已经完成了，你可以选择 archive。这样的话空间的内容将会减少展示次数，但是在你需要的时候，你还是可以参考空间中的内容。 https://www.cwiki.us/display/CONF6ZH/Create+a+Space
空间权限 每一个空间将会创建一个默认的权限。创建空间的用户将会自动具有空间管理员（space admin）的权限，这个的意思是你可以为其他用户和用户组赋予空间访问和管理的权限。 请查看 Space Permissions Overview 页面获得更多的相关信息。 系统管理员可以随时对 Confluence 的空间权限进行编辑和修改。 链接到相关的空间 你可以使用标签来链接到相关空间。每一个标签将会为空间创建一个分类，将所有具有相同标签的空间都归类到这个分类下面。 你也可以为空间添加添加一个 space description，能够保证访问者从每一个分类中访问到正确的空间。 为了帮助你在相关的空间中进行导航，你可以在页面中使用 Spaces List Macro 来对分类进行过滤。这个将会允许你在你的空间中插入具有某一个特定分类的所有空间列表。例如你可以利用这个功能，在你的小组空间中列出你项目小组正在工作的所有项目空间 如果你只希望链接相关内容的特定页面，而不是整个空间，你可以使用 Content Report Table Macro。例如你可以利用这个功能来在空间所有工作场所目录来创建所有团队成员列表页面，在这个页面中包含有你组织中每个人的角色和详细联系方式。 https://www.cwiki.us/display/CONF6ZH/Create+a+Space
在 Confluence 中并不限制你可以创建多少空间。你可以选择为你每一个小组，项目都创建一个空间，或者你也可以将这 2 者混合在一起。所有的这些都基于你的需求来决定的. 每一个 Confluence 中的空间都是具有自主权，这表示在每一个空间中，你都可以： 拥有空间自己的主页，博客页面，页面，评论，文件附件和 RSS 新闻源。 可以自定义不同的配色主题，标志和边栏。 可以拥有空间自己的的权限，这个是通过空间管理员进行设置的。 例如，一个 IT 小组可以创建一个自己的总体空间，同时包括所有他们自己的 Roadmap，细节和子项目组，例如质量保障（ Quality Assurance），开发人员（Developers），文档（Documentation），同时包含有快速指南，长期计划和知识文章。这些小组工作的的项目同时也可以有自己的空间，这些是可以通过使用标签（labels）来关联到小组空间中来的。 创建一个个人空间 你的个人空间总是被你自己所有的，你可以使用你的个人空间来保存你自己独立的工作，跟踪计划任务，博客页面或者你可能希望将一些工作保存为你自己可见，直到你准备将你的工作分享出去 在 Confluence 的顶部右侧界面中，选择你的 属性图片（profile picture），然后单击 添加个人空间（Add Personal Space..） 选择 创建（Create） 你可以为你的个人空间修改权限，这样你可以决定谁可以访问你的个人空间，谁不可以访问你的个人空间。如果你想使用个人空间为你自己信息的避难所，也是完全没有问题的。 为了你能够创建一个个人空间，你需要具有 个人空间（Personal Space）这个全局权限才可以。 创建一个站点空间 你可以为任何小组，项目创建一个站点空间，使用这个空间的小组和站点用户可以协同进行工作存储相关的文件附件。你可以以一个空白空间的方式进行创建，或者使用蓝图。 蓝图被称为空间蓝图（space blueprints），被用来帮助你更加容易的创建小组空间，知识库（KB）空间，或者文档空间。 在顶部单击 空间（Spaces） > 创建空间（Create space）。 选择一个空间的类型。 输入必要的信息后创建你的空间。 在输入空间标识（Key）的时候要小心，你不可以对空间标识进行修改。 每一个你创建的空间将会自动为你创建一个空间主页，你可以查看这个空间的用户自定义展示的信息。 当你在创建一个空间的时候使用了空间蓝图，这可能会导致你的空间主页被自定义。 你需要具有创建空间（Create Space）的全局权限才能创建一个站点空间。 https://www.cwiki.us/display/CONF6ZH/Create+a+Space
什么是一个空间? Confluence 空间是包含有页面和博客页面的容器。你也可以将空间认为是对你工作中可以使用的 2 中类型的目录。 在 Confluence 中有下面 2 种空间类型： 站点空间（Site spaces） – 这些空间可以在 空间目录（Space Directory）中找到。 在这里你可以创建与其他用户共享内容和合作文档。有时候也被称为全局空间。 个人空间（Personal spaces） – 每一个 Confluence 的用户都可以设置他们自己的个人空间。你可以让这些空间保持为私有的空间，或者将这些空间开放让其他用户查看和编辑。个人空间将会在 用户目录（People Directory）中立列出来。 你可以通过在 Confluence 顶部的 Spaces > Create space （空间 > 创建空间）来 Create a Space。你可以在这个空间中存储相关的分类信息。人们使用 Confluence 空间的主要有下面 2 类原因：为项目小组创建一个空间，或者为一个项目创建一个空间。 可以为市场小组，开发小组，IT 小组，人力资源小组等需要进行工作协调的部门创建一个空间。如果你有很多项目，不管你的项目是大项目还是小项目，为一个项目创建一个空间将会为你的项目带来很多好处，任何可以在项目空间中协同工作，存储相关文件。 在 Confluence 中，可以创建无限的空间。 我该如何使用一个空间？ 创建（Create）尽可能多的空间来更好的完成你需要的任务： 小组空间（Team spaces） – 给每个小组（QA, HR, Engineering, Support, ...）自己的空间，这样他们可以更加容易的找到他们需要的信息或让其他人也能更加容易的找到需要的信息。 项目空间（Project spaces） – 将所有与你项目有关的信息都放在一个地方。这个能够让项目小组中每一个成员都能够分享信息，而不用不停的发送电子邮件。 个人空间（Personal space） – 将所有你自己有关的工作保存在你的个人空间中，保存你自己的任务列表，同时你在将你的内容移动到其他任何共享空间之前对移动的内容进行修改。 随时了解空间 Watch a space to stay up-to-date with any changes. Add important spaces to your dashboard so that they're easy to find again. 空间管理员 如果你具有空间的管理员权限，你可以： Change the colors, logo, sidebar and homepage of that space. Control who can view and edit your space. Make your space public to share it with people who don't have access to Confluence. 空间权限 一些需要明确了解的有关空间管理员需要的信息： 创建空间的用户将会自动具有空间管理员的权限。 空间管理员权限可以将管理员权限赋权给其他用户。 空间管理员并不需要成为 Confluence 的管理员，空间管理员与系统管理员可以拥有不同的权限选项。例如不管你在空间中具有什么样的权限，你都是你个人空间的管理员。 希望了解更多有关使用空间的的建议？请参考下面的一些指南： Use Confluence as a Knowledge Base Develop Technical Documentation in Confluence Use Confluence as your Intranet Use Confluence for Software Teams https://www.cwiki.us/display/CONF6ZH/Spaces
我们希望你已经成功的完成了这个任务，同时还学习到了一些有关 Confluence 空间的多样性和强大的功能。后推到 18 个月以后，我们来看看你的火星移民计划进行的怎么样了。 如果你希望删除老的空间（或者销毁失败任务的证据）。你可以选择归档一个空间做着删除一个空间。归档空间的意思是，归档的空间在正常搜索的时候是不会显示出来的。删除空间就是完全的删除有关空间的所有内容。 希望对空间进行归档： 在左侧边栏的下端，选择 空间工具（Space tools）> 概要（Overview ） 单击 编辑空间细节（Edit Space Details） 修改 状态（Status ）从 'Current' 到 'Archived' 然后单击 保存（Save） 希望删除一个空间： 在左侧边栏的下端，选择 空间工具（Space tools）> 概要（Overview ） 选择 删除空间（Delete Space）选项卡 下一步我们干什么？ 如果你希望进一步的了解有关空间和权限已经如何进行管理的话，请参考 Confluence 文档中的 Spaces and Permissions and restrictions 页面中的内容。 空间总部中的项目小组签约完成。 中文标题【删除和归档空间】 https://www.cwiki.us/display/CONF6ZH/Delete+and+archive+spaces
现在是我们可以开始创建公众空间的时候了，全世界都希望知道这个项目和勇敢的探险活动。 在这个步骤中，我们将会创建一个项目小组的空间，并且将这个空间公布给全世界。这个表示的是你将会让你的 Confluence 空间允许匿名用户（没有登录的用户）进行访问。 为了让匿名用户能够访问 Confluence，站点的管理员需要为匿名用户赋予 'Use Confluence' 的权限。 如果你现在还不能进行这个操作的话，也不用担心。这个只是当你将 Confluence 向全世界发布的时候需要注意的一个问题。 创建一个小组空间 在顶部选择 空间（Spaces ）> 创建空间（Create space） 选择 小组空间（Team Space）然后单击 下一步（Next） 输入一个 空间的名字（Space name）让我们将这个空间称为 'Mars PR' 修改 空间的标识（Space key）为 'MarsPR' 如果现在还有其他的项目小组成员在使用 Confluence，你可以自由的添加 项目小组成员（Team members）到这个空间中，你也可以随后删除它们。或者，现在不添加，就你自己是项目组成员。 请粘贴下面的 描述（Description）：Paste this in as the : Follow the progress of the brave Teams in Space astronauts as they embark on their mission to colonize Mars。（描述是英文，我们就不翻译了，针对中文项目，你可以选择添加中文信息）。 很好，你现在已经有一个项目空间了，同时这个空间还拥有自己的主页。这个项目的主页和项目空间以及个人空间的主页有一点点不同。你将会看到所有你添加的项目成员被列在主页上了。 每一个你创建的空间都会有一个自己的博客页面。你的社交媒体成员可以直接粘贴博客和与粉丝进行互动。但是请注意，现在你的粉丝还不能查看这个空间的内容。 允许匿名用户访问 通过修改这个空间的权限，现在你就可以开始让全世界都能查看你的空间了。 在左侧边栏的底部选择 空间工具（Space tools）> 权限（Permissions ）。 滚动屏幕到页面的底部直到你可以看到 匿名用户（Anonymous）然后单击 编辑权限（Edit Permissions）。 为匿名用户选择上 查看（View ）权限，然后单击 保存所有（Save all）。 好了，现在你可以将你空间的 URL 分享出去了，空间的 URL 的结构有可能是 http(s)://<your_confluence_site>/display/MarsPR。访问这个空间的用户不需要进行登录，或者需要 Confluence 的许可证。 https://www.cwiki.us/display/CONF6ZH/Create+the+team%27s+PR+space
作为一个项目中的新手，你可能希望将一些工作保存为你自己可见，直到你准备将你的工作分享出去。同时你可能会收到任务指挥中心发送的只针对你的任务，你也希望这些任务能存储在一个安全的地方。 针对类似这样任务需求，我们将会创建一个特殊类型的空间：一个个人空间。我们将会使用你的个人空间作为沙盒，至少在开始的时候是这样的 - 你可以在沙盒中进行一些有关 Confluence 的测试，草稿页面，测试一些特性，同时也可以了解到空间能干什么。 创建你的个人空间 在你个人空间的的 Confluence 的头部，你可以选型你的属性图片。 选择 添加个人空间（Add Personal Space...） 单击 创建（Create） 现在你已经创建了只属于你自己的个人空间。但是我们还是要刚才创建的个人空间进行检查，以确保这个个人空间只能你自己访问。 从左侧边栏的底部选择 空间工具（Space tools） > 权限（Permissions ） 单击 编辑权限（Edit Permissions）如果这个时候 Confluence 提示需要输入密码的话，请输入你的密码。 你应该可以在 用户组（Groups）选项卡下面看到 confluence-users 用户组列表。在左侧的权限列表中有一个 查看（View）权限，这个通常用来定义在这个用户组中的用户能够查看你的空间。 取消选择 查看（View ）然后单击页面底部的 保存所有（Save all） and hit at the bottom of the page 现在只有你自己才能查看这个空间。你可以在这个空间中做任何你想做的事情，甚至可以存储高度保密的信息和资料。 https://www.cwiki.us/display/CONF6ZH/Create+your+personal+space
火星移民小组的程序需要一个地方能够调出他们任务的相关关键信息和资源，你的任务就是帮助他们实现和管理这个需求。这部分是比较容易实现的，因为这些信息需要让空间项目组中完全可见。 这样的话，你就可以设置项目空间同时还不需要任何特使的权限。 如果你还没有完成这方面的工作，你可以打开 Confluence 后然后开始下面的设置。 创建空间 从 Confluence 的顶部导航中 选择 空间（Spaces） > 创建空间（Create space）。 选择 空白空间（Blank space）选项，然后选择下一步（Next）。 为这个空间选择输入一个 空间名称（Space name） – 我们可以将这个空间称为 'Mars Colony'，这个空间将会被火星移民项目使用。 修改 空间标识（Space key）为 'MARS' – 这一步当然不是必须的，但是如果你的项目组成员知道空间标识的话，能够帮助人们在空间中进行快速的导航和切换。空间的标识将会成为 URL 中的一部分，所以你需要让你的空间标识的名字能够更好的让项目快速访问到。 单击 创建（Create）。 现在你已经完成了火星移民项目的空间设置。因为所有项目组的成员，包括空间总部的成为都需要能够访问这个空间的信息，因此你不需要为这个空间的访问权限做任何设置。通常这个项目针对你项目租来说是完全可见的，但是针对外部用户是不可见的。 每一个空间都需要有一个默认的主页，你可以对这个主页进行自定义配置来满足你的项目需求。通过在空间主页中添加下面的图片，来让你的空间开始运作。通过单击编辑（Edit ）（或者单击你键盘上的 E 键），然后开始拷贝粘贴文本。如果是图片的话，最好将需要添加的图片先保存到本地计算机中，然后将需要上传的图片拖动到编辑的界面中。这样能够保证图片直接上传到空间的服务器上。 当你对你修改的主要表示满意的时候，单击 保存（Save ）。 人类火星登录计划 从 20 世纪到 21 世纪已经被认为是有关 science fiction, engineering 的主题。这个计划被包括有在 火星 上降落，对 settling on 进行评估和使形态发生改变。这个项目将会利用月球 火卫一（Phobos） 和火卫二（Deimos）进行。 火星探险已经是国际间的空间项目超过几十年了。初步的任务与人类在20世纪50年代进行的空间探险活动息息相关。这个项目已经经历过了 10 到 30 多年的计划。20 世纪火星项目计划列表中显示了多个空间组织在这一任务领域太空探索的提案。 你的 'Mars colony' 空间已经Wie你的的项目小组添加了页面。如果你希望再次找到添加的页面，在 Confluence 的顶部选择 空间（Spaces ）。然后从弹出的列表中选择你希望进入的空间。如果你希望向你的空间中添加页面，在 Confluence 的顶部，单击 创建（Create ）。 现在，在你的个人空间中你可以独立进行编辑和不受干扰，并且能够保证没有人能够查看到你的工作。 https://www.cwiki.us/display/CONF6ZH/Create+a+project+space