前言
這是在老師 @阿爾法二狗 的指導(dǎo)下第一次參與workshop,從一開始的項目要求到需求分析再到代碼設(shè)計,整個過程下來對Springboot有了較全面的了解黍衙,也對項目的開發(fā)應(yīng)該具備的思路有了宏觀的概念,我以前拿到項目就開始分析,代碼設(shè)計誓焦,到最后看清楚需求的具體要求致使之前設(shè)計的代碼全部推倒重新設(shè)計,竊以為着帽,設(shè)計的過程應(yīng)該是又大到小再到大的過程杂伟,將需求細化分析,整理分到各個步驟模塊仍翰,在從最基礎(chǔ)的部分一個模塊一個模塊的實現(xiàn)赫粥,最后由這些小模塊再組成整個系統(tǒng)。
參考資料:
http://www.infoq.com/cn/news/2017/06/Dont-learn-code-Learn-think
http://blog.csdn.net/jsyxcjw/article/details/46763639/
http://www.infoq.com/cn/articles/microframeworks1-spring-boot/
1予借、spring boot
1.1 spring boot 簡介
Spring Boot是由Pivotal團隊提供的全新框架越平,其設(shè)計目的是用來簡化新Spring應(yīng)用的初始搭建以及開發(fā)過程频蛔。該框架使用了特定的方式來進行配置,從而使開發(fā)人員不再需要定義樣板化的配置秦叛。通過這種方式帽驯,Boot致力于在蓬勃發(fā)展的快速應(yīng)用開發(fā)領(lǐng)域(rapid application development)成為領(lǐng)導(dǎo)者。
從最根本上來講书闸,Spring Boot就是一些庫的集合尼变,它能夠被任意項目的構(gòu)建系統(tǒng)所使用。
- Spring Boot具有如下特性:
- 為基于Spring的開發(fā)提供更快的入門體驗
- 開箱即用浆劲,沒有代碼生成嫌术,也無需XML配置。同時也可以修改默認值來滿足特定的需求牌借。
- 提供了一些大型項目中常見的非功能性特性度气,如嵌入式服務(wù)器、安全膨报、指標磷籍,健康檢測、外部配置等现柠。
- Spring Boot的目標不在于為已解決的問題域提供新的解決方案院领,而是為平臺帶來另一種開發(fā)體驗,從而簡化對這些已有技術(shù)的使用
1.2 系統(tǒng)配置
開發(fā)工具為intellij ideal 2017.2
使用到開發(fā)工具中的maven和spring initializr
Spring Boot建議使用Maven或Gradle够吩,本文以Maven為例比然。
(maven要使用Java本) 打開cmd檢查版本
C:\Users\Administrator>mvn -v
Apache Maven 3.5.0 (ff8f5e7444045639af65f6095c62210b5713f426; 2017-04-04T03:39:06+08:00)
Maven home: D:\Apache-MAVEN\bin\..
Java version: 1.8.0_92, vendor: Oracle Corporation
Java home: C:\Program Files\Java\jdk1.8.0_92\jre
Default locale: zh_CN, platform encoding: GBK
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"
2、第一個Spring boot項目:基于RestfulAPI的Service服務(wù)-Micro-Service to ingestion auto seller data
2.1 pom.xml文件配置
新建springboot 項目周循,目錄src下有兩個文件main和Test强法,代碼寫在main中,Test是單元測試代碼
在目錄中有一個pom.xml
@requires_authorization
<?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.kbkj</groupId>
<artifactId>plant</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>jar</packaging>
<name>plant</name>
<description>SpringMarket</description>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.3.5.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-aop</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
pom.xml 可以進行依賴管理
GroupID 項目組織唯一的標識符湾笛,實際對應(yīng)JAVA的包的結(jié)構(gòu)饮怯,是main目錄里java的目錄結(jié)構(gòu)。
ArtifactID 是項目的唯一的標識符嚎研,實際對應(yīng)項目的名稱蓖墅,就是項目根目錄的名稱。
version 使用版本
<groupId>com.kbkj</groupId>
<artifactId>plant</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>jar</packaging>
2.2 創(chuàng)建新項目
在plant\src\main\resources\application.properties,配置數(shù)據(jù)庫連接
spring.datasource.url = jdbc:mysql://localhost:3306/supermaker?createDatabaseIfNotExist=true&useUnicode=true&characterEncoding=utf-8&autoReconnect=true
spring.datasource.username = root
spring.datasource.password = root
spring.datasource.driverClassName = com.mysql.jdbc.Driver
# Specify the DBMS
spring.jpa.database = MYSQL
# Show or not log for each sql query
spring.jpa.show-sql = true
# Hibernate ddl auto (create, create-drop, update)
spring.jpa.hibernate.ddl-auto = update
# Naming strategy
spring.jpa.hibernate.naming-strategy = org.hibernate.cfg.ImprovedNamingStrategy
spring.jpa.properties.hibernate.dialect = org.hibernate.dialect.MySQL5Dialect
因為maven會默認編譯在src/main/java下的代碼嘉赎,所以/java文件中創(chuàng)建三個文件夾置媳,分別是contrller(控屬于展示層的一部分)于樟、services(業(yè)務(wù)層)公条、modle(作為數(shù)據(jù)的結(jié)構(gòu)化載體貫穿整個展示層、業(yè)務(wù)層和數(shù)據(jù)層).
在編寫代碼時迂曲,可以由上至下的開發(fā)靶橱,也可以由下至上開發(fā).
package com.kbkj.plant.controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping({"/hello"})
public class PlantsController {
@RequestMapping(value = "/text",method = {RequestMethod.GET})
public String RepublecController(){
return "hello world";
}
}
@RestController和@RequestMapping說明:
@RestController 被稱為一個構(gòu)造型(stereotype)注解。它為閱讀代碼的人們提供建議。對于Spring关霸,該類扮演了一個特殊角色传黄。我們的類是一個web @Controller,所以當處理進來的web請求時队寇,Spring會詢問它膘掰。
@RequestMapping 注解提供路由信息。它告訴Spring任何來自"/"路徑的HTTP請求都應(yīng)該被映射到home方法佳遣。@RestController注解告訴Spring以字符串的形式渲染結(jié)果识埋,并直接返回給調(diào)用者。
package com.kbkj.plant;
import org.springframework.boot.SpringApplication;
@SpringBootApplication
public class PlantApplication {
public static void main(String[] args) {
SpringApplication.run(PlantApplication.class, args);
}
}
main方法零渐。這只是一個標準的方法窒舟,它遵循Java對于一個應(yīng)用程序入口點的約定。我們的main方法通過調(diào)用run诵盼,將業(yè)務(wù)委托給了Spring Boot的SpringApplication類惠豺。SpringApplication將引導(dǎo)我們的應(yīng)用,啟動Spring风宁,相應(yīng)地啟動被自動配置的Tomcat web服務(wù)器洁墙。
除了常見的Spring框架事件,比如ContextRefreshedEvent戒财,一個SpringApplication也發(fā)送一些額外的應(yīng)用事件扫俺。一些事件實際上是在ApplicationContext被創(chuàng)建前觸發(fā)的。
- 可以使用多種方式注冊事件監(jiān)聽器固翰,最普通的是使用SpringApplication.addListeners(…)方法狼纬。在應(yīng)用運行時,應(yīng)用事件會以下面的次序發(fā)送:
在運行開始骂际,但除了監(jiān)聽器注冊和初始化以外的任何處理之前疗琉,會發(fā)送一個ApplicationStartedEvent。
在Environment將被用于已知的上下文歉铝,但在上下文被創(chuàng)建前盈简,會發(fā)送一個ApplicationEnvironmentPreparedEvent。
在refresh開始前太示,但在bean定義已被加載后柠贤,會發(fā)送一個ApplicationPreparedEvent。
啟動過程中如果出現(xiàn)異常类缤,會發(fā)送一個ApplicationFailedEvent臼勉。
開始運行,控制臺輸出
"C:\Program Files\Java\jdk1.8.0_92\bin\java" -XX:TieredStopAtLevel=1 -noverify -
. ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v1.3.5.RELEASE)
2017-06-20 11:09:12.697 INFO 2764 --- [ main] com.kbkj.plant.PlantApplication : Starting PlantApplication on BF-20160708YRVN with PID 2764 (E:\plant\target\classes started by Administrator in E:\plant)
2017-06-20 11:09:12.703 INFO 2764 --- [ main] com.kbkj.plant.PlantApplication : No active profile set, falling back to default profiles: default
2017-06-20 11:09:12.795 INFO 2764 --- [ main] ationConfigEmbeddedWebApplicationContext : Refreshing org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@4b9e255: startup date [Fri Jun 20 11:09:12 CST 2017]; root of context hierarchy
2017-06-20 11:09:14.442 INFO 2764 --- [ main] trationDelegate$BeanPostProcessorChecker : Bean 'org.springframework.transaction.annotation.ProxyTransactionManagementConfiguration' of type [class org.springframework.transaction.annotation.ProxyTransactionManagementConfiguration$$EnhancerBySpringCGLIB$$f5fdcdc6] is not eligible for getting processed by all BeanPostProcessors (for example: not eligible for auto-proxying)
打開瀏覽器輸入localhost:8080 可以看到
hello world
2.3 Spring Beans和依賴注入
在程序的編寫中可以自由地使用任何標準的Spring框架技術(shù)去定義beans和它們注入的依賴餐弱。簡單起見宴霸,常用@ComponentScan注解搜索beans囱晴,并結(jié)合@Autowired構(gòu)造器注入。
如果使用上面建議的結(jié)構(gòu)組織代碼(將應(yīng)用類放到根包下)瓢谢,可以添加@ComponentScan注解而不需要任何參數(shù)畸写。你的所有應(yīng)用程序組件(@Component, @Service, @Repository, @Controller等)將被自動注冊為Spring Beans。
2.4 Micro-Service to ingestion auto seller data 代碼設(shè)計
設(shè)計之前氓扛,要知道本次項目是為了設(shè)計一個超市自動化收銀程序枯芬,目的是在銀行打折,和國內(nèi)外產(chǎn)品采郎,買多贈送破停,這些條件的基礎(chǔ)上自動計算出最后總價格。
首先知道應(yīng)該具有的屬性尉剩,
package com.kbkj.plant.model;
/**
* Created by Administrator on 2017/6/10 0010.
*/
public class SaleInfo {
private String productNum;
private int count;
public String getProductNum() {
return productNum;
}
public void setProductNum(String productNum) {
this.productNum = productNum;
}
public int getCount() {
return count;
}
public void setCount(int count) {
this.count = count;
}
}
設(shè)計接口
package com.kbkj.plant.services;
import com.kbkj.plant.model.SaleInfo;
import java.util.List;
public interface DataFormat {
List<SaleInfo> format (List<String> saleInfo);
}
實現(xiàn)方法
package com.kbkj.plant.services;
import com.kbkj.plant.model.SaleInfo;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
/**
* Created by Administrator on 2017/6/10 0010.
*/
public class DataFormatImpl implements DataFormat {
public List<SaleInfo> format(List<String> saleInfo){
HashMap<String,Integer> output = new HashMap<String,Integer>();
for(String item:saleInfo){
String productNumber = item;
int count = 1;
if(item.contains("-")){
String [] splitted = item.split("-");
productNumber = splitted[0];
count = new Integer(splitted[1]);
}
if(!output.containsKey(productNumber)){
output.put(productNumber,count);
}else {
output.put(productNumber,output.get(productNumber)+count);
}
}
List<SaleInfo> results = new ArrayList();
for (String key : output.keySet()) {
SaleInfo item = new SaleInfo();
item.setProductNum(key);
item.setCount(output.get(key));
results.add(item);
}
return results;
}
}
2.5 @Test 單元測試
在pom.xml里面可以添加單元測試需要的jar
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
@RunWith(SpringJUnit4ClassRunner.class) 指定我們SpringBoot工程的Application啟動類
@SpringApplicationConfiguration(classes = App.class)由于是Web項目真慢,Junit需要模擬ServletContext,因此我們需要給我們的測試類加上@WebAppConfiguration理茎。
@WebAppConfiguration 測試環(huán)境使用黑界,用來表示測試環(huán)境使用的ApplicationContext將是WebApplicationContext類型的,value指定web應(yīng)用的根
package com.kbkj.plant.services;
import com.kbkj.plant.PlantApplication;
import com.kbkj.plant.model.SaleInfo;
import org.junit.Before;
import org.junit.Test;
import org.junit.Assert;
import org.junit.runner.RunWith;
import java.util.ArrayList;
import java.util.List;
import org.springframework.boot.test.SpringApplicationConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
import org.springframework.test.context.web.WebAppConfiguration;
@RunWith(SpringJUnit4ClassRunner.class)
@SpringApplicationConfiguration(classes = PlantApplication.class)
@WebAppConfiguration
public class DataFomatImplTest {
private DataFormat subject;
@Before
public void setup(){
subject = new DataFormatImpl();
}
@Test
public void testIfDataFormatCanFormatData(){
List<String> input = new ArrayList();
input.add("10001");
input.add("10001");
input.add("10001-2");
input.add("10002-2");
input.add("10002-3");
input.add("10003-1");
List<SaleInfo> output = subject.format(input);
Assert.assertEquals(output.get(0).getProductNum(), "10001");
Assert.assertEquals(output.get(0).getCount(), "4");
Assert.assertEquals(output.get(1).getProductNum(), "10002");
Assert.assertEquals(output.get(1).getCount(), "5");
Assert.assertEquals(output.get(2).getProductNum(),"10003");
Assert.assertEquals(output.get(2).getCount(),"1");
}
}
3 學(xué)習(xí)總結(jié)
熟悉了解spring boot的創(chuàng)建皂林,以及設(shè)計結(jié)構(gòu)朗鸠,依賴的配置,maven的使用础倍。
對于項目的需求分析方法
在收到客戶需求后烛占,一定要對需求進行詳盡的分析,將需求按照重要程度排序沟启,將需求盡可能的細化忆家,功能進行拆分,將有邏輯關(guān)系的功能模塊進行分析德迹,找到進入模塊的類型再考慮從邏輯模塊出來的類型芽卿,有進必要有出,數(shù)據(jù)類型也要統(tǒng)一胳搞。設(shè)計好模塊的輸入和要求的輸出卸例,完成好最低級需求的分析后才可開始按模塊的進行開發(fā)。
總結(jié)一下上面所說的肌毅,在做項目時筷转,開發(fā)與測試應(yīng)該同步進行,編程能力是每個工程師都應(yīng)該提升的能力悬而,但編程本身并不是我們的目的呜舒。計算機和程序只是工具,它們是我們通向終點的橋梁摊滔。學(xué)習(xí)編程思想的真正的目標應(yīng)該是教會人們?nèi)绾嗡伎迹?/p>