hebin

18 程序员英语/spring.ioquickstart.md

@@ -0,0 +1,217 @@
+# spring.io/quickstart
+
+本期课程讲解Spring官网的`快速上手`页面
+
+官网地址 https://spring.io/quickstart
+
+## Spring Quickstart Guide
+
+![image-20200324153553651](images-02/image-20200324153553651-1585035408093.png)Spring 快速开始指南
+
+**Guide**
+
+指南
+
+### What you'll build
+
+接下来你将要构建的是什么？
+
+**build**
+
+构建
+
+#### You will build a classic “Hello World!” endpoint which any browser can connect to. You can even tell it your name, and it will respond in a more friendly way.
+
+您将构建一个经典的“Hello World!”任何浏览器都可以连接的端点。你甚至可以告诉它你的名字，它会以一种更友好的方式回应你。
+
+#### **You will build a classic “Hello World!”** **endpoint which any browser can connect to**
+
+你将要构建的是一个经典的 helloworld端点，任何浏览器都可以连接上。
+
+**classic**  经典的
+
+**endpoint** 端点，终端
+
+**browser** 浏览器
+
+**connect** 连接
+
+####  **You can even tell it your name, and it will respond in a more friendly way.**
+
+你甚至可以告诉它你的名字，它会以一种更友好的方式回应你。
+
+**respond** 应答
+
+### What you’ll need
+
+你需要什么
+
+#### An Integrated Developer Environment (IDE)
+
+一个集成开发环境
+
+**Integrated** 集成
+
+**Developer** 开发
+
+**Environment** 环境
+
+#### Popular choices include [IntelliJ IDEA](https://www.jetbrains.com/idea/), [Spring Tools](https://spring.io/tools), [Visual Studio Code](https://code.visualstudio.com/docs/languages/java), or [Eclipse](https://www.eclipse.org/downloads/packages/), and many more.
+
+比较流行的选择包括 IntelliJ IDEA, Spring Tools, Visual Studio Code, 或者Eclipse，等等。
+
+**include** 包含，包括 
+
+#### A Java™ Development Kit (JDK)
+
+对jdk的要求
+
+We recommend [AdoptOpenJDK](https://adoptopenjdk.net/) version 8 or version 11.
+
+我们推荐使用 **AdoptOpenJDK** 8 或者 11版。
+
+**recommend** 建议，推荐
+
+## Step 1: Start a new Spring Boot project
+
+第一步，创建一个新的springboot项目
+
+**Step** 步骤
+
+**project** 项目
+
+#### Use [start.spring.io](https://start.spring.io/) to create a “web” project.
+
+使用**start.spring.io**这个网站创建一个web项目
+
+**create** 创建
+
+#### In the “Dependencies” section search for and add the “web” dependency as shown in the screenshot. 
+
+在“依赖项”部分，搜索并添加“web”依赖，如屏幕截图所示。
+
+**Dependencies** 依赖
+
+**section** 一部分
+
+**search**搜索
+
+**shown in ....** 如xx所示
+
+**screenshot** 屏幕截图
+
+![The Spring Initializr (spring-quickstart-img/quick-img-1-e0f70cc841acda493440a5560cbc66da.png) being asked to generate a simple Spring Boot ‘Web’ project. Hitting the ‘generate’ button will create an archive of a project which you can unpack and use to get started.](https://spring.io/images/quick-img-1-e0f70cc841acda493440a5560cbc66da.png)
+
+Hit the green “Generate” button, download the zip, and unpack it into a folder on your computer.
+
+点击绿色的**生成**按钮，下载zip文件，并将其解压缩到你电脑上上的一个文件夹里。
+
+**Hit** 点击
+
+**Generate**生成
+
+**button** 按钮
+
+**download** 下载
+
+**zip** 压缩格式
+
+**unpack** 解开，解压缩
+
+**folder** 文件夹
+
+## Step 2: Add your code
+
+第二步，添加你的代码
+
+#### Open up the project in your IDE and locate the `DemoApplication.java` file in the `src/main/java/com/example/demo`folder. 
+
+用ide打开刚下载的项目，并在`src/main/java/com/example/demo`文件夹中找到`DemoApplication.java`文件
+
+**locate** 定位，位于
+
+#### Now change the contents of the file by adding the extra method and annotations shown in the code below. 
+
+现在，修改文件内容，添加一些额外的方法和注解，如下代码所示
+
+**change** 改变，修改 
+
+**contents** 内容
+
+**file** 文件 
+
+**extra**  额外，扩展
+
+**method** 方法 
+
+**annotations** 注解（不是注释）
+
+```java
+              package com.example.demo;
+              import org.springframework.boot.SpringApplication;
+              import org.springframework.boot.autoconfigure.SpringBootApplication;
+              import org.springframework.web.bind.annotation.GetMapping;
+              import org.springframework.web.bind.annotation.RequestParam;
+              import org.springframework.web.bind.annotation.RestController;
+
+              @SpringBootApplication
+              @RestController
+              public class DemoApplication {
+
+
+                  public static void main(String[] args) {
+                  SpringApplication.run(DemoApplication.class, args);
+                  }
+
+                  @GetMapping("/hello")
+                  public String hello(@RequestParam(value = "name", defaultValue = "World") String name) {
+                  return String.format("Hello %s!", name);
+                  }
+
+              }
+
+```
+
+
+
+#### You can copy and paste the code or just type it.
+
+你可以直接复制粘贴代码，或者自己敲。
+
+#### The `hello()` method we’ve added is designed to take a String parameter called `name`, and then combine this parameter with the word `"Hello"` in the code. 
+
+`hello()`这个方法是我们添加的，我们把它设计成了一个可以接受String类型参数的方法，这个参数名是`name`,在方法体里，连接了`"Hello"`这个词。
+
+**designed** 设计的
+
+**take a String parameter** 获取到一个String类型的参数
+
+**combine** 连接，联合 
+
+#### This means that if you set your name to `“Amy”` in the request, the response would be `“Hello Amy”`.
+
+这么写的意思是，如果在请求发过来的时候`name`这个参数被设置成了`amy`,那么响应的结果就是`“Hello Amy”`
+
+**request** 请求
+
+**response** 响应 
+
+#### The `@RestController` annotation tells Spring that this code describes an endpoint that should be made available over the web. 
+
+`@RestController`这个注解告诉Spring，我们的这些代码想要开启一个可用的web服务端点
+
+**describes**  描述
+
+#### The `@GetMapping(“/hello”)` tells Spring to use our `hello()` method to answer requests that get sent to the `http://localhost:8080/hello` address. 
+
+`@GetMapping(“/hello”)` 这个注解写在了`hello()`这个方法上，告诉Spring我们想用这个方法应答请求，当请求地址为`http://localhost:8080/hello`时会执行这个方法
+
+**address** 地址
+
+#### Finally, the `@RequestParam` is telling Spring to expect a `name` value in the request, but if it’s not there, it will use the word “World” by default.
+
+最后，`@RequestParam` 告诉Spring在处理请求时，期望接收到一个传递过来的`'name'`值，但是如果没有传值过来那么就使用`' World '`这个词作为默认值。
+
+**expect** 期望
+
+**default** 默认