Ant - wdrażanie aplikacji

W poprzednim rozdziale dowiedzieliśmy się, jak spakować aplikację i wdrożyć ją w folderze.

W tym rozdziale zamierzamy wdrożyć aplikację internetową bezpośrednio w folderze wdrażania serwera aplikacji, a następnie dodamy kilka celów Ant, aby uruchamiać i zatrzymywać usługi. KontynuujmyHello Worldaplikacja internetowa do faksowania. Jest to kontynuacja poprzedniego rozdziału, w którym wyróżniono nowe komponentybold.

build.properties

# Ant properties for building the springapp

appserver.home = c:\\install\\apache-tomcat-7.0.19
# for Tomcat 5 use $appserver.home}/server/lib
# for Tomcat 6 use $appserver.home}/lib
appserver.lib = ${appserver.home}/lib

deploy.path = ${appserver.home}/webapps

tomcat.manager.url = http://www.tutorialspoint.com:8080/manager
tomcat.manager.username = tutorialspoint
tomcat.manager.password = secret

build.xml

<?xml version = "1.0"?>

<project name = "fax" basedir = "." default = "usage">
   <property file = "build.properties"/>
   <property name = "src.dir" value = "src"/>
   <property name = "web.dir" value = "war"/>
   <property name = "javadoc.dir" value = "doc"/>
   <property name = "build.dir" value = "${web.dir}/WEB-INF/classes"/>
   <property name = "name" value = "fax"/>

   <path id = "master-classpath">
      <fileset dir = "${web.dir}/WEB-INF/lib">
         <include name = "*.jar"/>
      </fileset>
   
   <pathelement path = "${build.dir}"/>
   </path>
    
   <target name = "javadoc">
      <javadoc packagenames = "faxapp.*" sourcepath = "${src.dir}" 
         destdir = "doc" version = "true" windowtitle = "Fax Application">

         <doctitle><![CDATA[<h1> =  Fax Application  =  </h1>]]></doctitle>
         <bottom><![CDATA[Copyright © 2011. All Rights Reserved.]]></bottom>
         <group title = "util packages" packages = "faxapp.util.*"/>
         <group title = "web packages" packages = "faxapp.web.*"/>
         <group title = "data packages" packages = "faxapp.entity.*:faxapp.dao.*"/>
      </javadoc>
   </target>

   <target name = "usage">
      <echo message = ""/>
      <echo message = "${name} build file"/>
      <echo message = "-----------------------------------"/>
      <echo message = ""/>
      <echo message = "Available targets are:"/>
      <echo message = ""/>
      <echo message = "deploy    --> Deploy application as directory"/>
      <echo message = "deploywar --> Deploy application as a WAR file"/>
      <echo message = ""/>
   </target>

   <target name = "build" description = "Compile main source tree java files">
   
      <mkdir dir = "${build.dir}"/>
      
      <javac destdir = "${build.dir}" source = "1.5" target = "1.5" debug = "true"
         deprecation = "false" optimize = "false" failonerror = "true">
         <src path = "${src.dir}"/>
         <classpath refid = "master-classpath"/>
      </javac>
   </target>

   <target name = "deploy" depends = "build" description = "Deploy application">
      <copy todir = "${deploy.path}/${name}" 
         preservelastmodified = "true">
         
         <fileset dir = "${web.dir}">
            <include name = "**/*.*"/>
         </fileset>
      </copy>
   </target>

   <target name = "deploywar" depends = "build" description =
      "Deploy application as a WAR file">
      
      <war destfile = "${name}.war" webxml = "${web.dir}/WEB-INF/web.xml">
         <fileset dir = "${web.dir}">
            <include name = "**/*.*"/>
         </fileset>
      </war>
      
      <copy todir = "${deploy.path}" preservelastmodified = "true">
         <fileset dir = ".">
            <include name = "*.war"/>
         </fileset>
      </copy>
   </target>

   <target name = "clean" description = "Clean output directories">
      <delete>
         <fileset dir = "${build.dir}">
            <include name = "**/*.class"/>
         </fileset>
      </delete>
   </target>

   <!-- ============================================================ -->
   <!-- Tomcat tasks -->
   <!-- ============================================================ -->

   <path id = "catalina-ant-classpath">
      <!-- We need the Catalina jars for Tomcat -->
      <!--  * for other app servers - check the docs -->
      
      <fileset dir = "${appserver.lib}">
         <include name = "catalina-ant.jar"/>
      </fileset>
   </path>

   <taskdef name = "install" classname = "org.apache.catalina.ant.InstallTask">
      <classpath refid = "catalina-ant-classpath"/>
   </taskdef>

   <taskdef name = "reload" classname = "org.apache.catalina.ant.ReloadTask">
      <classpath refid = "catalina-ant-classpath"/>
   </taskdef>

   <taskdef name = "list" classname = "org.apache.catalina.ant.ListTask">
      <classpath refid = "catalina-ant-classpath"/>
   </taskdef>

   <taskdef name = "start" classname = "org.apache.catalina.ant.StartTask">
      <classpath refid = "catalina-ant-classpath"/>
   </taskdef>

   <taskdef name = "stop" classname = "org.apache.catalina.ant.StopTask">
      <classpath refid = "catalina-ant-classpath"/>
   </taskdef>

   <target name = "reload" description = "Reload application in Tomcat">
      <reload url = "${tomcat.manager.url}"username = "${tomcat.manager.username}"
         password = "${tomcat.manager.password}" path = "/${name}"/>
   </target>
</project>

W tym przykładzie użyliśmy Tomcat jako naszego serwera aplikacji. Najpierw w pliku właściwości kompilacji zdefiniowaliśmy kilka dodatkowych właściwości.

Plik appserver.home wskazuje ścieżkę instalacyjną do serwera aplikacji Tomcat.
Plik appserver.lib wskazuje na pliki bibliotek w folderze instalacyjnym Tomcat.
Plik deploy.path zmienna wskazuje teraz folder webapp w Tomcat.

Aplikacje w Tomcat można zatrzymywać i uruchamiać za pomocą aplikacji Tomcat Manager. Adres URL aplikacji menedżera, nazwa użytkownika i hasło są również określone w pliku build.properties. Następnie deklarujemy nową ścieżkę CLASSPATH zawierającą rozszerzeniecatalina-ant.jar. Ten plik jar jest wymagany do wykonywania zadań Tomcat za pośrednictwem Apache Ant.

Catalina-ant.jar zapewnia następujące zadania -

Sr.No.	Właściwości i opis
1	InstallTask Instaluje aplikację internetową. Nazwa klasy: org.apache.catalina.ant.InstallTask
2	ReloadTask Załaduj ponownie aplikację internetową. Nazwa klasy: org.apache.catalina.ant.ReloadTask
3	ListTask Zawiera listę wszystkich aplikacji internetowych. Nazwa klasy: org.apache.catalina.ant.ListTask
4	StartTask Uruchamia aplikację internetową. Nazwa klasy: org.apache.catalina.ant.StartTask
5	StopTask Zatrzymuje aplikację internetową. Nazwa klasy: org.apache.catalina.ant.StopTask
6	ReloadTask Ponownie ładuje aplikację internetową bez zatrzymywania. Nazwa klasy: org.apache.catalina.ant.ReloadTask

Zadanie przeładowania wymaga następujących dodatkowych parametrów -

Adres URL do aplikacji menedżera
Nazwa użytkownika do ponownego uruchomienia aplikacji internetowej
Hasło do ponownego uruchomienia aplikacji internetowej
Nazwa aplikacji internetowej do ponownego uruchomienia

Wydamy deploy-warpolecenie skopiowania aplikacji internetowej do folderu Tomcat webapps, a następnie przeładujmy aplikację internetową Fax. Poniższy wynik jest wynikiem działania pliku Ant -

C:\>ant deploy-war
Buildfile: C:\build.xml

BUILD SUCCESSFUL
Total time: 6.3 seconds

C:\>ant reload
Buildfile: C:\build.xml

BUILD SUCCESSFUL
Total time: 3.1 seconds

Po uruchomieniu powyższego zadania aplikacja internetowa jest wdrażana, a aplikacja internetowa jest ponownie ładowana.