SpringBoot开发入门一
SpringBoot是一个简化Spring应用开发的框架,是整个Spring技术栈的一大整合,也是J2EE开发的一站式解决方案。接下来通过一个简单的员工管理系统来讲解SpringBoot Web的开发过程。
创建SpringBoot Web应用
开发SpringBoot应用的首选软件是IDEA,这里也会使用IDEA来创建一个springboot web应用。
- 首先点击new—>project,选择Spring Assistant(每个版本的idea会略有不同,老版本是spring initializr),如图所示:
如果没有这个选项,点击setting,选择plugins,在搜索框里搜索Spring Assistant,安装后重启IDEA即可。
- 点击next,进入如下界面,填写Group Id,Artifact Id以及Project name 等信息,可以选择java版本以及打包方式,默认是jar打包。填好之后点击next.
- 创建文web应用,选择Web,勾选Spring Web Starter即可,如果还需要其他的功能,可以依次勾选,这里只需要web即可。
- 点击next,填写好Project name,点击Finish,就可以自动创建一个Spring Boot应用。需要注意的是创建过程中需要联网才能完成。
编写HelloWorld程序
- 上面创建号Spring Boot 应用后,会自动生成主程序类,位于com.xxx.xxx下面,代码如下:
@SpringBootApplication
public class SpringBoot04WebRestfulcrudApplication {
public static void main(String[] args) {
SpringApplication.run(SpringBoot04WebRestfulcrudApplication.class, args);
}
}
其中@SpringBootApplication 来标注一个主程序类,说明这是一个Spring Boot应用,SpringApplication.run()让Spring应用程序启动起来。
2. 编写控制类,在com.xx.xx包下创建一个新的文件夹,例如controller文件夹,并在里面新建一个HelloController类,类代码如下:
@Controller
public class HelloController {
@ResponseBody
@RequestMapping("/hello")
public String hello(){
return "hello world";
}
}
- @Controller注解用来说明这是一个控制类,功能相当于Spring中的xml文件。
- @responseBody注解的作用是将controller的方法返回的对象通过适当的转换器转换为指定的格式之后,写入到response对象的body区,通常用来返回JSON数据或者是XML数据,需要注意的呢,在使用此注解之后不会再走试图处理器,而是直接将数据写入到输入流中,他的效果等同于通过response对象输出指定格式的数据。
- @RequestMapping是一个用来处理请求地址映射的注解,可用于类或方法上。用于类上,表示类中的所有响应请求的方法都是以该地址作为父路径。
- 点击主程序类中main方法左侧的三角按钮运行主程序,打开浏览器,输入http:localhost:8080/hello,如图所示,表示运行成功
- 修改配置文件,改变端口。
默认的端口是8080端口,如果想要更改端口就需要修改配置文件,创建好应用后,会在resources下自动生成一个空文件application.properties,这是SpringBoot的全局配置文件,配置文件名是固定的,但可以有两种后缀名,分别是application.properties和application.yml,它的作用是修改SpringBoot自动配置的默认值,SpringBoot在底层都给我们自动配置好。以修改端口号为例,yaml格式如下:
server:
port: 8081
k:(空格)v:表示一对键值对(空格必须有);
以空格的缩进来控制层级关系;只要是左对齐的一列数据,都是同一个层级的
properties格式如下:
server.port=8081
配置文件值注入
- 编写javaBean,在com.xxx.xxx下创建bean文件夹,用来专门存放javaBean,新建Dog类和Person类,代码如下:
Dog.java:
package com.lixing.spingboot.bean;
public class Dog {
private String name;
private Integer age;
@Override
public String toString() {
return "Dog{" +
"name='" + name + '\'' +
", age=" + age +
'}';
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public Integer getAge() {
return age;
}
public void setAge(Integer age) {
this.age = age;
}
}
person.java:
package com.lixing.spingboot.bean;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.PropertySource;
import org.springframework.stereotype.Component;
import java.util.Date;
import java.util.List;
import java.util.Map;
@PropertySource(value = {"classpath:person.properties"})
@Component
@ConfigurationProperties(prefix = "person")
public class Person {
private String lastName;
private Integer age;
private Boolean boss;
private Date birth;
private Map<String,Object> maps;
private List<Object> lists;
private Dog dog;
@Override
public String toString() {
return "Person{" +
"lastName='" + lastName + '\'' +
", age=" + age +
", boss=" + boss +
", birth=" + birth +
", maps=" + maps +
", lists=" + lists +
", dog=" + dog +
'}';
}
public String getLastName() {
return lastName;
}
public void setLastName(String lastName) {
this.lastName = lastName;
}
public Integer getAge() {
return age;
}
public void setAge(Integer age) {
this.age = age;
}
public Boolean getBoss() {
return boss;
}
public void setBoss(Boolean boss) {
this.boss = boss;
}
public Date getBirth() {
return birth;
}
public void setBirth(Date birth) {
this.birth = birth;
}
public Map<String, Object> getMaps() {
return maps;
}
public void setMaps(Map<String, Object> maps) {
this.maps = maps;
}
public List<Object> getLists() {
return lists;
}
public void setLists(List<Object> lists) {
this.lists = lists;
}
public Dog getDog() {
return dog;
}
public void setDog(Dog dog) {
this.dog = dog;
}
}
- @PropertySource(value = {“classpath:person.properties”}),用来指明要加载的配置文件,默认是application.properties和application.yml,如果是application.properties或application.yml,则不需要写。
- @Component,把普通pojo实例化到spring容器中,相当于配置文件中的
- @ConfigurationProperties(prefix = “person”),告诉SpringBoot将本类中的所有属性和配置文件中相关的配置进行绑定; prefix = “person”:配置文件中哪个(person)下面的所有属性进行一一映射
- 在类目录下创建person.yml文件,通常所说的类路径classpath是指java文件夹下和resources文件夹下,resources文件夹主要用来存放一些非java代码的文件,如静态文件js,html等,还包括图片,配置文件等。这里是放在resources文件夹下。
person.yml:
person:
lastName: hello
age: 18
boss: false
birth: 2017/12/12
maps: {k1: v1,k2: 12}
lists:
- lisi
- zhaoliu
dog:
name: 小狗
age: 12
如果是properties文件,则格式如下:
person.properties:
person.last-name=张三
person.age=18
person.birth=2017/12/15
person.boss=false
person.maps.k1=v1
person.maps.k2=14
person.lists=a,b,c
person.dog.name=小狗
person.dog.age=15
- 编写测试类
在test中的测试类中添加如下代码进行测试,只是打印出person,检查是否注入成功。
package com.lixing.spingboot;
import com.lixing.spingboot.bean.Person;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
@RunWith(SpringRunner.class)
@SpringBootTest
public class SpringBoot02ConfigApplicationTests {
@Autowired
Person person;
@Test
public void contextLoads() {
System.out.println(person);
}
}
- @Autowired:表示被修饰的类需要注入对象,spring会扫描所有被@Autowired标注的类,然后根据 类型 在ioc容器中找到匹配的类注入。
输出结果如下: -
Person{lastName='张三', age=18, boss=false, birth=Fri Dec 15 00:00:00 CST 2017, maps={k1=v1, k2=14}, lists=[a, b, c], dog=Dog{name='小狗', age=15}}
配置文件注意事项
- 如何在Springboot中使用xml配置文件问题。
@ImportResource:如果需要使用xml格式的配置文件,需要导入Spring的配置文件,让配置文件里面的内容生效;Spring Boot里面没有Spring的配置文件,我们自己编写的配置文件,也不能自动识别;想让Spring的配置文件生效,必须加载进来;@ImportResource标注在一个配置类上,如下:
@ImportResource(locations = {"classpath:beans.xml"})
导入Spring的配置文件让其生效
springboot推荐使用全注解的方式给容器添加组件
/**
* @Configuration:指明当前类是一个配置类;就是来替代之前的Spring配置文件
*
* 在配置文件中用<bean><bean/>标签添加组件
*
*/
@Configuration
public class MyAppConfig {
//将方法的返回值添加到容器中;容器中这个组件默认的id就是方法名
@Bean
public HelloService helloService02(){
System.out.println("配置类@Bean给容器中添加组件了...");
return new HelloService();
}
}
- @Configuration:加在类前面说明这是一个Spring配置文件。
- @Bean:给容器添加组件。
- properties没有自动提示的问题。
我们可以在pom.xml中导入配置文件处理器,以后编写配置就有提示了。
<!--导入配置文件处理器,配置文件进行绑定就会有提示-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-configuration-processor</artifactId>
<optional>true</optional>
</dependency>
- properties配置文件在idea中乱码问题。
默认是utf-8编码,需要在Transparent native-to-asscii conversion前面打对勾即可。
- 配置文件如何使用占位符问题
- 随机数
${random.value}、${random.int}、${random.long}
${random.int(10)}、${random.int[1024,65536]}
person.last-name=张三${random.uuid}
person.age=${random.int}
person.birth=2017/12/15
person.boss=false
person.maps.k1=v1
person.maps.k2=14
person.lists=a,b,c
person.dog.name=${person.hello:hello}_dog
person.dog.age=15