[JAVA_Spring]Spring 3.2.2的各類jar說明

一、下載Spring Framework 資料
http://www.springsource.org/download/community
圖

二、解壓資料
jar檔在spring-framework-3.2.2.RELEASE-dist\spring-framework-3.2.2.RELEASE\libs
資料夾中，在每一種類型有三種jar

1、*.RELEASE.jar     -- 此為一般jar檔，只有class檔。
2、*.javadoc         -- 此為javadoc。
3、*.sources         -- 此為來原程式碼，有java檔。

Spring Framework 3.2.2 目前共有19大項，清冊為：

1、spring-aop-3.2.2.RELEASE.jar
2、spring-aspects-3.2.2.RELEASE.jar
3、spring-beans-3.2.2.RELEASE.jar
4、spring-context-3.2.2.RELEASE.jar
5、spring-context-support-3.2.2.RELEASE.jar
6、spring-core-3.2.2.RELEASE.jar
7、spring-expression-3.2.2.RELEASE.jar
8、spring-instrument-3.2.2.RELEASE.jar
9、spring-instrument-tomcat-3.2.2.RELEASE.jar
10、spring-jdbc-3.2.2.RELEASE.jar
11、spring-jms-3.2.2.RELEASE.jar
12、spring-orm-3.2.2.RELEASE.jar
13、spring-oxm-3.2.2.RELEASE.jar
14、spring-struts-3.2.2.RELEASE.jar
15、spring-test-3.2.2.RELEASE.jar
16、spring-tx-3.2.2.RELEASE.jar
17、spring-web-3.2.2.RELEASE.jar
18、spring-webmvc-3.2.2.RELEASE.jar
19、spring-webmvc-portlet-3.2.2.RELEASE.jar
圖

註:
  以前會有spring.jar ，在3.0.3以後就不再提供了。
4、spring-build-src-3.2.2.RELEASE.jar

三、各類jar說明
1、spring-aop-3.2.2.RELEASE.jar

提供AOP（Aspect-Oriented Programming）(切面導向程式設計)實現，

2、spring-aspects-3.2.2.RELEASE.jar

Spring提供對AspectJ框架的整合

3、spring-beans-3.2.2.RELEASE.jar

springIoC（依賴注入）的基礎實現，所有應用都要用到的，它包含訪問配置文件、創建和
管理bean以及進行Inversion of Control / Dependency Injection（IoC/DI）操作相關的所有類。

4、spring-context-3.2.2.RELEASE.jar

Spring提供在基礎IoC功能上的擴展服務，
可以找到使用Spring ApplicationContext
  特性時所需的全部類，JDNI所需的全部類，UI方面的用來與模板（Templating）引擎如Velocity、FreeMarker、
  JasperReports集成的類，以及校驗Validation方面的相關類。
此外還提供許多企業級服務的支持，
如郵件服務、任務調度、JNDI定位、EJB集成、遠程訪問、緩存以及各種視圖層框架的封裝等。

5、spring-context-support-3.2.2.RELEASE.jar

spring-context 的擴展支持，包含支持緩存Cache（ehcache）、JCA、JMX、
郵件服務（Java Mail、COS Mail）、任務計劃Scheduling（Timer、Quartz）方面的類。

6、spring-core-3.2.2.RELEASE.jar

Spring框架基本的核心工具類。
Spring其它組件要都要使用到這個包裏的類，是其它套件的基本核心。

7、spring-expression-3.2.2.RELEASE.jar

spring 表達式語言。

8、spring-instrument-3.2.2.RELEASE.jar

該模塊包括Spring代理Java虛擬機（JVM）的引導。
這需要使用AspectJ JAR檔。

9、spring-instrument-tomcat-3.2.2.RELEASE.jar

該模塊包括Spring代理JVM引導Tomcat服務器，
對Tomcat的連接池的應用整合。

7.8.4.6 Environment-specific configuration
http://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/html/aop.html#Tomcat

10、spring-jdbc-3.2.2.RELEASE.jar

包含對Spring對JDBC數據訪問進行封裝的所有類。

11、spring-jms-3.2.2.RELEASE.jar

為簡化JMS API的使用而作的應用整合

12、spring-orm-3.2.2.RELEASE.jar

包含Spring對DAO特性集進行了擴展，使其支持iBATIS、JDO、OJB、TopLink，
因為Hibernate已經獨立成包了，現在不包含在這個包裡了。
這個jar文件里大部分的類都要依賴spring-dao.jar裡的類，
用這個包時你需要同時包含spring-dao.jar包。
spring-hibernate3 及 spring-dao 需另外下載。

13、spring-oxm-3.2.2.RELEASE.jar

Spring 對Object/XMl的映射支持,可以讓Java與XML之間來回切換。

14、spring-struts-3.2.2.RELEASE.jar

Struts框架支持，可以更方便更容易的集成Struts框架。

15、spring-test-3.2.2.RELEASE.jar

對Junit的等測試框架的應用整合。

16、spring-tx-3.2.2.RELEASE.jar

Spring Transaction
為JDBC、Hibernate、JDO、JPA等提供的一致的聲明式和編程式事務管理。

17、spring-web-3.2.2.RELEASE.jar

包含Web應用開發時，用到Spring框架時所需的核心類，包括自動載入
WebApplicationContext特性的類、Struts與JSF集成類、文件上傳的支持類、Filter類和大量工具輔助類。

18、spring-webmvc-3.2.2.RELEASE.jar

Spring Web MVC

19、spring-webmvc-portlet-3.2.2.RELEASE.jar

SpringMVC的增强。

三、Spring 3.0模組依賴關係圖

Diagram of Spring 3.0 module dependencies
http://ogrigas.eu/spring/2009/12/diagram-of-spring-3-0-module-dependencies

正如你可以看到，有幾組模塊：

"Core Spring" - context 其依賴關係（ASM遺漏，AOP依賴於它）

Web

web - 基本的web應用整合

webmvc (web.servlet) - Spring MVC Framework

webmvc-portlet (web.portlet) - Spring MVC 入口網站應用程式

web.struts - Struts 應用整合

Data access

tx (transaction) - 基本的交易支援
jdbc - JDBC 支援
orm - ORM 應用整合

Other modules

context-support - 應用整合 Quartz, Javamail, Ehcache, etc
jms, oxm - JMS and object-XML mapping respectively
test - for unit testing
aspects - AspectJ intergration (usually not needed)
instrument, instrument.tomcat - 相關服務器的代理接口


四、其它spring相關套件

另外還有常用的到有
spring-hibernate-1.2.9.jar 等等。

可以到 mvnrepository 下載。
http://mvnrepository.com/artifact/org.springframework


五、相關參考網站：

Spring 官網
http://www.springsource.org/spring-framework

Spring  download
http://www.springsource.org/download/community

Spring Framework 3.2.2.RELEASE API
http://static.springsource.org/spring/docs/3.2.x/javadoc-api/

Spring Framework Reference Documentation
http://static.springsource.org/spring/docs/3.2.x/spring-framework-reference/html/

Spring maven
http://blog.springsource.org/2009/12/02/obtaining-spring-3-artifacts-with-maven/


Spring jar版本相關介紹
https://github.com/SpringSource/spring-framework/wiki/Downloading-Spring-artifacts

其它文章

[JAVA_Spring]建立一個Spring MVC fileupload project

本文使用 Spring Web model-view-controller (MVC) framework
建立一個簡單的一個檔案上傳程式

1、本文中使用的相關技術

Eclipse 4.2 Version: Juno Service Release 2
Maven 3.0.5
JAVA JDK 1.6.0_24
Spring 3.2.2.RELEASE。

P.S Spring 3.x, 需 JDK 1.5 以上。

2、建立一個Maven專案

P.S 請參考前一篇文章 建立一個基本簡單的Spring MVC project

3、加入 Spring 3.0 jar
加入在Maven專案中的pom.xml

程式碼：

<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/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.sample</groupId>
  <artifactId>SpringMVC_File_Upload_sample</artifactId>
  <packaging>war</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <name>SpringMVC_File_Upload_sample Maven Webapp</name>
  <url>http://maven.apache.org</url>

  <build>
      <finalName>SpringMVC_File_Upload_sample</finalName>
  </build>

  <properties>
      <spring.version>3.2.2.RELEASE</spring.version>
  </properties>

  <dependencies>
          <!-- Spring 3 dependencies -->
   <dependency>
         <groupId>org.springframework</groupId>
     <artifactId>spring-core</artifactId>
     <version>${spring.version}</version>
   </dependency>
 
   <dependency>
     <groupId>org.springframework</groupId>
     <artifactId>spring-web</artifactId>
     <version>${spring.version}</version>
   </dependency>
 
   <dependency>
     <groupId>org.springframework</groupId>
     <artifactId>spring-webmvc</artifactId>
     <version>${spring.version}</version>
          </dependency>
   
          <dependency>
 <groupId>org.springframework</groupId>
 <artifactId>spring-context-support</artifactId>
 <version>${spring.version}</version>
 </dependency>
  <!--  jstl dependencie  -->
          <dependency>
 <groupId>jstl</groupId>
 <artifactId>jstl</artifactId>
 <version>1.2</version>
 </dependency>
  <!--  file dependencie  -->
 <dependency>
 <groupId>commons-fileupload</groupId>
 <artifactId>commons-fileupload</artifactId>
 <version>1.3</version>
 </dependency>
         
  </dependencies>

</project>

4. 建立JSP 頁面
目錄 : src/main/webapp/
檔名 : index.jsp

<jsp:forward page="show.html"></jsp:forward>

目錄 : src/main/webapp/WEB-INF/jsp
檔名 : file_upload_form.jsp


程式碼：

<%@taglib uri="http://www.springframework.org/tags/form" prefix="form"%>
<html>
<head>
<title>Spring MVC Multiple File Upload</title>
</head>
<body>
<h1>Spring Multiple File Upload example</h1>

<form:form method="post" action="save.html"
modelAttribute="uploadForm" enctype="multipart/form-data">

<p>please select file </p>
<table>
<tr>
<td><input name="files[0]" type="file" /></td>
</tr>
</table>
<br/><input type="submit" value="Upload" />
</form:form>
</body>
</html>

目錄 : src/main/webapp/WEB-INF/jsp
檔名 : file_upload_success.jsp

程式碼：

<%@taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
<html>
<head>
<title>Spring MVC Multiple File Upload</title>
</head>
<body>
<h1>Spring Multiple File Upload example</h1>
<p>Following files are uploaded successfully.</p>
<ol>
<c:forEach items="${files}" var="file">
<li>${file}</li>
</c:forEach>
</ol>
</body>
</html>

5. 加入spring設定到Web application web.xml

檔名 : web.xml
程式碼：

<web-app
xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
version="3.0">

  <display-name>Archetype Created Web Application</display-name>

  <servlet>
 <servlet-name>spring</servlet-name>
 <servlet-class>
   org.springframework.web.servlet.DispatcherServlet
 </servlet-class>
 <load-on-startup>1</load-on-startup>
  </servlet>

  <servlet-mapping>
 <servlet-name>spring</servlet-name>
 <url-pattern>*.html</url-pattern>
  </servlet-mapping>

</web-app>

6. 建立 Spring mvc Config xml 檔

檔名: spring-servlet.xml

程式碼：

<?xml  version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:context="http://www.springframework.org/schema/context"

xmlns:mvc="http://www.springframework.org/schema/mvc"

xsi:schemaLocation="http://www.springframework.org/schema/beans 

http://www.springframework.org/schema/beans/spring-beans.xsd

http://www.springframework.org/schema/context 

http://www.springframework.org/schema/context/spring-context.xsd

http://www.springframework.org/schema/mvc 

http://www.springframework.org/schema/mvc/spring-mvc.xsd">

 <context:annotation-config />

 <context:component-scan base-package="com.springmvc.fileupload.sample.controller"/>

 <bean id="multipartResolver"

  class="org.springframework.web.multipart.commons.CommonsMultipartResolver"/>

  <bean id="jspViewResolver"

class="org.springframework.web.servlet.view.InternalResourceViewResolver">

<property name="viewClass"

value="org.springframework.web.servlet.view.JstlView" />

<property name="prefix" value="/WEB-INF/jsp/" />

<property name="suffix" value=".jsp" />

  </bean>

</beans>

7. 建立可
以暫時存放檔案的資料型態

如：
目錄 : src/main/java/com/springmvc/fileupload/sample/form
檔名 : FileUploadForm.java
 程式碼：

package com.springmvc.fileupload.sample.form;

import java.util.List;

import org.springframework.web.multipart.MultipartFile;

public class FileUploadForm {

 private List files;

 public List getFiles() {
  return files;
 }

 public void setFiles(List files) {
  this.files = files;
 }
}

8. 建立Controller & Mapping
    在Spring 3 裡大量使用 annotation 。

如：
@Controller
目錄 : src/main/java/com/springmvc/fileupload/sample/controller
檔名 : FileUploadController.java
程式碼：

package com.springmvc.fileupload.sample.controller;

import java.util.ArrayList;
import java.util.List;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.multipart.MultipartFile;

import com.springmvc.fileupload.sample.form.FileUploadForm;

@Controller
public class FileUploadController {

 @RequestMapping(value = "/show", method = RequestMethod.GET)
 public String displayForm() {
  return "file_upload_form";
 }
 
 @RequestMapping(value = "/save", method = RequestMethod.POST)
 public String save(
   @ModelAttribute("uploadForm") FileUploadForm uploadForm,
     Model map) {
  
  List files = uploadForm.getFiles();

  List fileNames = new ArrayList();
  
  if( files != null && files.size() > 0 ) {
   for (MultipartFile multipartFile : files) {
    String fileName = multipartFile.getOriginalFilename();
    fileNames.add(fileName);
   }
  }
  
  map.addAttribute("files", fileNames);
  return "file_upload_success";
 }
}

9. 結果

其它文章

[JAVA_Spring]建立一個基本簡單的Spring MVC project

本文使用 Spring Web model-view-controller (MVC) framework
建立一個簡單的一個Hello World 程式

1、本文中使用的相關技術

Eclipse 4.2 Version: Juno Service Release 2
Maven 3.0.5
JAVA JDK 1.6.0_41
Spring 3.2.2.RELEASE

P.S Spring 3.x, 需 JDK 1.5 以上。

2、建立一個Maven專案
使用Eclipse創建
 
File -> New -> Other (快速鍵Ctrl+ N)

選擇Maven -> Maven Project

本文使用  創建一個簡單的專案 ->下一步

輸入專案名稱，本文為springMVCDemo_1


記得將專案加入JAVA WEB Project 相關資料夾及檔案。
如：
 web.xml

 本文這裡預設你己經會建置JAVA WEB Project。

3、加入 Spring 3.0 jar
   加入在Maven專案中的pom.xml

程式碼：
<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/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>springMVCDemo_1</groupId>
  <artifactId>springMVCDemo_1</artifactId>
  <packaging>war</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <name>springMVCDemo_1 Maven Webapp</name>
  <url>http://maven.apache.org</url>

  <build>
    <finalName>springMVCDemo_1</finalName>
  </build>

  <properties>
<spring.version>3.2.2.RELEASE</spring.version>
</properties>

<dependencies>

<!-- Spring 3 dependencies -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>${spring.version}</version>
</dependency>

<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>${spring.version}</version>
</dependency>

<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>${spring.version}</version>
</dependency>

<!-- junit dependencies -->
<dependency>
     <groupId>junit</groupId>
     <artifactId>junit</artifactId>
     <version>3.8.1</version>
     <scope>test</scope>
 </dependency>
</dependencies>

</project>

 
4. 建立Controller & Mapping
    在Spring 3 裡大量使用 annotation 。


如：
@Controller
@RequestMapping("/myMain")
目錄 : src/main/java/com/springmvc/demo/controller
檔名 : MyMainController.java

程式碼：

  package com.springmvc.demo.controller;

  import org.springframework.stereotype.Controller;
  import org.springframework.ui.ModelMap;
  import org.springframework.web.bind.annotation.RequestMapping;
  import org.springframework.web.bind.annotation.RequestMethod;

  @Controller
  @RequestMapping("/myMain")
  public class MyMainController {
   
   
   @RequestMapping(value = "/show",method = RequestMethod.GET)
   public String show(ModelMap model) {
   
    model.addAttribute("message", "Hi , Spring 3 MVC Hello World");
    return "hello";
   
   }
   
  }

3. 建立JSP 頁面
目錄 : src/main/webapp/WEB-INF/views/
檔名 : hello.jsp
程式碼：
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<html>
<head>
<title>Spring MVC</title>
</head>
<body>
<h1>${message}</h1>
</body>
</html>

4. 建立 Spring mvc Config xml 檔

在DispatcherServlet初始化後的，
Spring MVC預設會在/WEB-INF/ 資料夾中，
找一個名為 [servlet-name]-servlet.xml，並創建有定義的Bean，
且會覆蓋具有相同名稱的任何定義的bean的定義，在global範圍裡。

檔名: mvc-dispatcher-servlet.xml
在程式碼中的
<context:component-scan base-package="com.springmvc.demo" />
base-package="你的bean package "


程式碼：
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="
        http://www.springframework.org/schema/beans  
        http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context-3.0.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd">

<context:component-scan base-package="com.springmvc.demo" />

<bean
class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix">
<value>/WEB-INF/views/</value>
</property>
<property name="suffix">
<value>.jsp</value>
</property>
</bean>

</beans>

5. 加入spring設定到Web application web.xml
設定是沒有什麼不同的，與舊的spring2.5.6比較的話，
只要聲明spring “ContextLoaderListener的”和“的DispatcherServlet”。
檔名 : web.xml
程式碼：
<web-app
xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
version="3.0">


  <display-name>Archetype Created Web Application</display-name>

  <servlet>
<servlet-name>mvc-dispatcher</servlet-name>
<servlet-class>
                       org.springframework.web.servlet.DispatcherServlet
                </servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>

  <!--Map the DispatcherServlet to a URL pattern -->
<servlet-mapping>
<servlet-name>mvc-dispatcher</servlet-name>
<url-pattern>/views/*</url-pattern>
</servlet-mapping>

<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/mvc-dispatcher-servlet.xml</param-value>
</context-param>

<listener>
<listener-class>
                      org.springframework.web.context.ContextLoaderListener
        </listener-class>
</listener>

</web-app>

6. Demo
URL : http://localhost:8080/springMVCDemo_1/views/myMain/show

設定web server Tomcat:

 加入Tomcat ok

 執行 Run on Server

 選擇server 後Finish

 執行成功畫面：

 專案目錄：

spring MVC 流程圖：
此圖重點 spring MVC 其它細項略過

其它文章