👍🏿 😐 👩🏽‍🏭 スプリングブート：開始から運用まで 👼🏻 🤸🏼 👖

この記事では、Spring Bootで小さなプロジェクトを作成し、戦闘サーバーに展開するために必要なすべての手順の概要を説明します。

JavaとSpringの哲学に関する長い前奏曲を引きずり出さないで、すぐにビジネスに取りかかります。

まず、必要なすべてのテクノロジー動物園（少なくともSpring、JPA、JDBC）を実装して、アプリケーションフレームワークを作成する必要があります。スプリングブートが登場する前は、もちろんコードビンに作業用のドラフトがない限り、これに多くの時間を費やす必要がありました。そして、多くの人がJavaで小さなWebプロジェクトを開発するのを止めるのは、そのようなフレームワークを作成する複雑さです。もちろん、パフォーマンスの低下（hiの側面）に似たフレームワークを作成することができなかった不自由な春のルーがあるとはいえ、それでも構成ファイルの数と複雑さにより、訓練されていない開発者は長い間それらを熟考しました。ただし、BootとSpring 4の登場により、生活が少し楽になり、構成ファイルの数が著しく減少しました。

そう、フレーム、はい。

Intellij Idea 14.1をお持ちの場合、フレームワークに問題はないはずです。プロジェクトを作成するための特別なウィザード（File-New-Project ...- Spring Initializr）を使用してすべてを実行できます。次に、プロジェクトの名前を示し、関心のあるテクノロジ（Web、JDBC、JPA、PostgreSQL）を選択してプロジェクトを作成するだけです。

このIDEがない場合は、 Spring Boot CLIをダウンロードして、INSTALL.txtの指示に従ってください。システム変数SPRING_HOME（binフォルダーではなく、Spring Bootのフォルダーへのパス！）を設定し、WindowsのPATHシステム変数にSPRING_HOME / binへのパスを追加する必要があります。

そこで、Spring Consoleをセットアップしました。今度はプロジェクトを作成します。これを行うには、次のコマンドを使用します。

spring init --dependencies=web,data-jpa,jdbc yourapp

更新
さらに、コメントで書いたように、Webコンストラクタもあります： start.spring.io

次に、結果のフレームワークをお気に入りのIDEにインポートし、ニーズに合わせて変更を開始します。

最初に、webappsフォルダーをsrc /メインディレクトリに追加します。春が望むように、resourcesフォルダーではなく、その中にすべてのWebリソースを作成します。実際、リソースフォルダーにファイルを作成すると、サーバーを再起動せずにWebリソースに加えられた変更を確認する機会が失われます。また、Webページ上の変更されたテキストを表示するためにWebサーバーを再起動する必要がある場合、これはイライラする可能性があります。

次に、webappsフォルダーに、適切なリソースを配置するindex.htmlファイルとcss、js、font、imagesフォルダーを作成します。

たとえば、最も単純なindex.htmlフレームワークを作成しましょう。

 <!DOCTYPE html> <html lang="en"> <head> <title>Yourapp</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/> </head> <body> <h1> HELLO WORLD </h1> </body> </html>

pom.xmlファイルを変更します
次のようなものが得られるはずです。

 <?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.yourcompany</groupId> <artifactId>yourapp</artifactId> <version>0.0.1-SNAPSHOT</version> <packaging>jar</packaging> <name>YourApp</name> <description></description> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>1.2.3.RELEASE</version> <relativePath/> <!-- lookup parent from repository --> </parent> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <start-class>com.yourcompany.Application</start-class> <java.version>1.8</java.version> </properties> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</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>com.zaxxer</groupId> <artifactId>HikariCP</artifactId> </dependency> <dependency> <groupId>org.postgresql</groupId> <artifactId>postgresql</artifactId> <version>9.4-1201-jdbc41</version> <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> <plugin> <artifactId>maven-resources-plugin</artifactId> <version>2.6</version> <executions> <execution> <id>copy-resources</id> <phase>validate</phase> <goals> <goal>copy-resources</goal> </goals> <configuration> <outputDirectory>${basedir}/target/classes/static</outputDirectory> <resources> <resource> <directory>src/main/webapp</directory> <filtering>true</filtering> </resource> </resources> </configuration> </execution> </executions> </plugin> </plugins> </build> </project>

pomファイルから次のことがわかります。
Java 8を使用します（試してみましょう）。アプリケーションクラスはcom.yourcompany.Applicationと呼ばれます（たとえば、DemoApplicationと呼ばれる標準生成クラスの名前を忘れないでください）。

postgresql 9.4を使用します（お使いのマシンにローカルにインストールするのもいいでしょう）。データベースとのやり取りのための接続プールは、最もファッショナブルで生産性の高い（HikariCP）です。さらに、特別なプラグインを使用して、最終的なjarを生成するときに、スプリングブートが必要とするように、すべてのデータをwebappからresources / staticに転送します。そうしないと、jarニックネームの実行時にwebappsフォルダーに作成したすべてのWebページを表示できません。

構成パッケージを追加し、その中にJpaConfigクラスを作成します。

 @Configuration @EnableTransactionManagement @EnableJpaRepositories(basePackageClasses = Application.class) public class JpaConfig implements TransactionManagementConfigurer { @Value("${dataSource.driverClassName}") private String driver; @Value("${dataSource.url}") private String url; @Value("${dataSource.username}") private String username; @Value("${dataSource.password}") private String password; @Value("${hibernate.dialect}") private String dialect; @Value("${hibernate.hbm2ddl.auto}") private String hbm2ddlAuto; @Bean public DataSource configureDataSource() { HikariConfig config = new HikariConfig(); config.setDriverClassName(driver); config.setJdbcUrl(url); config.setUsername(username); config.setPassword(password); return new HikariDataSource(config); } @Bean public LocalContainerEntityManagerFactoryBean configureEntityManagerFactory() { LocalContainerEntityManagerFactoryBean entityManagerFactoryBean = new LocalContainerEntityManagerFactoryBean(); entityManagerFactoryBean.setDataSource(configureDataSource()); entityManagerFactoryBean.setPackagesToScan("com.yourcompany"); entityManagerFactoryBean.setJpaVendorAdapter(new HibernateJpaVendorAdapter()); Properties jpaProperties = new Properties(); jpaProperties.put(org.hibernate.cfg.Environment.DIALECT, dialect); jpaProperties.put(org.hibernate.cfg.Environment.HBM2DDL_AUTO, hbm2ddlAuto); entityManagerFactoryBean.setJpaProperties(jpaProperties); return entityManagerFactoryBean; } @Bean public PlatformTransactionManager annotationDrivenTransactionManager() { return new JpaTransactionManager(); } }

さらに、application.propertiesファイルに次の行を追加します。

 dataSource.driverClassName=org.postgresql.Driver dataSource.url=jdbc:postgresql://<ip- ,   PostgreSQL>:5432/yourapp_data dataSource.username=postgres dataSource.password= hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect hibernate.hbm2ddl.auto=update

最後に、Application.javaで初期化文字列を次のように変更します。

 SpringApplication.run(new Class<?>[] {Application.class, JpaConfig.class}, args);

したがって、PostgreSQL DBMSへの接続を構成しました。

データベース自体と単純なテーブルを作成することを忘れないでください。これは、PgAdminを使用して行うのが最も便利です。
空のyourapp_dataデータベースを作成した後、テーブル作成スクリプトを実行します。

 CREATE TABLE yourapp_data ( data_id uuid NOT NULL, data_description character varying(100) NOT NULL, CONSTRAINT yourapp_data_pk PRIMARY KEY (data_id) ) WITH ( OIDS=FALSE ); ALTER TABLE yourapp_data OWNER TO postgres;

さあ、プロジェクトに少し詰め込みましょう。つまり、何らかの種類のデータベースエンティティを追加して操作方法を学習し、クライアントから形成のためにデータを受信し、既に作成されたエンティティに関する同じデータをクライアントに送信します。

コントローラ、エンティティ、リポジトリ、サービス、utilsパッケージを作成します。

エンティティパッケージで、インターフェイスを作成します。

 public interface DomainObject extends Serializable { }

そして本質：

 public class Data implements DomainObject { private UUID id; private String description; public Data(UUID id, String description) { this.id = id; this.description = description; } public UUID getId() { return id; } public void setId(UUID id) { this.id = id; } public String getDescription() { return description; } public void setDescription(String description) { this.description = description; } }

この例ではJPAおよびHibernateアノテーションを使用しません。これらのテクノロジーにより作業が大幅に遅くなるため（要求は純粋なjdbcよりも10倍遅く実行できる）、ORMが実際に必要とされる非常に複雑なエンティティがないため、その後、通常のjdbcTemplateを使用します。

リポジトリインターフェイスを作成します。

 public interface DataRepository<V extends DomainObject> { void persist(V object); void delete(V object); Set<String> getRandomData(); }

そしてその実装：

 @org.springframework.stereotype.Repository("dataRespitory") public class DataRepositoryImpl implements DataRepository<Data> { @Autowired protected JdbcOperations jdbcOperations; @Override public void persist(Data object) { Object[] params = new Object[] { object.getId(), object.getDescription() }; int[] types = new int[] { Types.VARCHAR, Types.VARCHAR }; jdbcOperations.update("INSERT INTO yourapp_data(\n" + " data_id, data_description)\n" + " VALUES (cast(? as UUID), ?);", params, types); } @Override public void delete(Data object) { jdbcOperations.update("DELETE FROM yourapp_data\n" + " WHERE data_id = '" + object.getId().toString() + "';"); } @Override public Set<String> getRandomData() { Set<String> result = new HashSet<>(); SqlRowSet rowSet = jdbcOperations.queryForRowSet("SELECT data_description FROM yourapp_data p ORDER BY RANDOM() LIMIT 50;"); while (rowSet.next()) { result.add(rowSet.getString("data_description")); } return result; } }

すでに説明したjdbcTemplateの代わりに、ご覧のとおり、インターフェイスであるJdbcOperationsを使用します。インターフェイスはどこからでも実装から分離する必要があります。第一に、スタイリッシュでファッショナブルで若々しく、第二に、春はオブジェクトに標準jdk'shnyプロキシを使用するため、実装を直接注入できないためです。本格的なアスペクトとAspectJコンパイル時ウィービングを紹介するまで。私たちの場合、アプリケーションをオーバーロードさせないためにこれは必要ありません。

すでに少しあります。サービスを作成します（優れた開発者であり、ビジネスロジックをDBMSと連携するロジックから分離する必要がありますか？）。

インターフェース：

 public interface DataService { public boolean persist(String problem); public Set<String> getRandomData(); }

実装：

 @Service("dataService") public class DataServiceImpl implements DataService { private static final Logger LOG = LoggerFactory.getLogger(DataServiceImpl.class); @Autowired @Qualifier("dataRespitory") private DataRepository dataRepository; @Override public boolean persist(String problem) { try { dataRepository.persist(new Data(UUID.randomUUID(), problem)); return true; } catch (Exception e) { LOG.error("ERROR SAVING DATA: " + e.getMessage(), e); return false; } } @Override public Set<String> getRandomData() { return dataRepository.getRandomData(); } }

素晴らしい。次に、コントローラーの実装に必要なヘルパークラスをいくつか作成します。

 public class RestException extends Exception { public RestException() { } public RestException(String message) { super(message); } public RestException(String message, Throwable cause) { super(message, cause); } public RestException(Throwable cause) { super(cause); } public RestException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) { super(message, cause, enableSuppression, writableStackTrace); } }

これが例外の実装です。必須ではありませんが、将来便利になる可能性がありますが、次のクラスが関連付けられています。

 @Controller public class ExceptionHandlerController { private static final Logger LOG = Logger.getLogger(ExceptionHandlerController.class); @ExceptionHandler(RestException.class) public @ResponseBody String handleException(RestException e) { LOG.error(": " + e.getMessage(), e); return ": " + e.getMessage(); } }

コントローラーでこのようなエラーをキャッチした場合、このメソッドでさらに処理されます。
最後に、クライアントに送信するためのデータ構造を形成する小さなクラシックを作成します。

 public class Ajax { public static Map<String, Object> successResponse(Object object) { Map<String, Object> response = new HashMap<String, Object>(); response.put("result", "success"); response.put("data", object); return response; } public static Map<String, Object> emptyResponse() { Map<String, Object> response = new HashMap<String, Object>(); response.put("result", "success"); return response; } public static Map<String, Object> errorResponse(String errorMessage) { Map<String, Object> response = new HashMap<String, Object>(); response.put("result", "error"); response.put("message", errorMessage); return response; } }

ヘルパークラスのすべてが完了しました。コントローラーを書くことは残っています。コルクと同じくらい簡単です：

 @Controller public class DataController extends ExceptionHandlerController { private static final Logger LOG = Logger.getLogger(DataController.class); @Autowired @Qualifier("dataService") private DataService dataService; @RequestMapping(value = "/persist", method = RequestMethod.POST) public @ResponseBody Map<String, Object> persist(@RequestParam("data") String data) throws RestException { try { if (data == null || data.equals("")) { return Ajax.emptyResponse(); } dataService.persist(data); return Ajax.emptyResponse(); } catch (Exception e) { throw new RestException(e); } } @RequestMapping(value = "/getRandomData", method = RequestMethod.GET) public @ResponseBody Map<String, Object> getRandomData() throws RestException { try { Set<String> result = dataService.getRandomData(); return Ajax.successResponse(result); } catch (Exception e) { throw new RestException(e); } } }

2つの方法があります-受信したデータを保存し、ランダムデータの一部をクライアントに提供します。コントローラーは、前に作成したExceptionHandlerControllerから継承されます。例外処理はテンプレートとしてのみ記述されており、それに応じて調整する必要があります。

そのため、サーバーコードの主要部分が記述され、クライアントでの動作を確認する必要があります。これを行うには、index.htmlファイルを改良すると同時に、jqueryライブラリをjsディレクトリに追加する必要があります。
index.html：

 <!DOCTYPE html> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/> <title>YourApp</title> <script src="js/jquery-2.1.3.min.js"></script> </head> <body> <h1> HELLO WORLD </h1> <input type="text" id="data"/> <a id="post" href="#">POST</a> <a id="get" href="#">GET</a> <div id="container"></div> </body> <script> $('#get').click(function () { $.ajax({ type: "GET", cache: false, url: '/getRandomData', data: "", success: function (response) { var html = ""; $.each(response.data, function (i) { html = html + response.data[i] + "<br/>"; }); $('#container').html(html); } }); }); $('#post').click(function () { if (!$("#data").val()) { alert("Enter your data!"); } else { $.ajax({ type: "POST", cache: false, url: '/persist', data: { 'data': $("#data").val() }, success: function (response) { $('#get').click(); } }); } }); </script> </html>

はい、UIはそれほど美しくはありませんでしたが、その助けを借りてアプリケーションをテストできます。
プロジェクトを実行します。 Intellij Ideaでは、これは特別なスタートアップ構成（スプリングブート）で実行できます。
すべてが正しく完了したら、localhost：8080でHello Worldヘッダー、入力行、2つのボタンを確認できます。入力行に何かを入力して、POSTボタンをクリックしてみてください。その後、入力フィールドの下に同様のテキストが表示される場合、すべてが正常に機能しています。ニーズに合わせてプロジェクトを変更し、ファッショナブルなUI（例： materializecss.com ）を追加し、合理的で親切な永遠のものを作成します。

しかし、遅かれ早かれ、あなたはあなたが望むことをするでしょう、そして、問題はあなたの頭脳を大衆にもたらす方法です。これは記事の第2部になります。

小さいながらも重要なものから始めましょう。
プロジェクトが小さい場合でも、独自のドメインが必要です。アイデアをただ走り回っているだけで、同じgodaddyにドメインを登録するのにあまりお金をかけたくない場合は、無料の代替手段freenom.comを使用できます。

このサービスでは、ドメインを.tk、.ml、.ga、.cf、.gqゾーンに無料で登録できます
はい、最良のゾーンではありませんが、次のとおりです。

次に、これらすべてが回転するサーバーを取り上げましょう。プロジェクトは小さいので、サーバーは小さく収まります。理想的には十分なVPS。 www.digitalocean.comなど、さまざまな場所で入手できます。
登録して、最も単純なドロップレットを作成し、その上にubuntuを配置します（私の場合はubuntu 12.04です、このシステムの詳細な手順について説明しますが、残りはほぼ同じです）

さて、サーバーがあります。プロジェクトをアップロードします。

開始するには、プロジェクトmaven'omを収集します。 IDEを介してこれを行うか、最悪の場合、プロジェクトのルートディレクトリに移動してmvn clean installコマンドを発行します（Windowsのシステム変数パスでmavenへのパスを指定する必要があります）。コマンドが完了すると、アセンブルされたjarはローカルリポジトリ（デフォルトでは.m2という名前）に配置され、そこからプルしてサーバーに送信できます。

Windowsを実行している場合、ファイルをサーバーに転送するには、 WinSCPを使用します。
次に、WindowsのputtyまたはLinuxのsshを使用してサーバーにアクセスします。
jar-nicknameがコピーされたディレクトリに移動し、java -jar youapp.jarコマンドで実行しようとします

おそらく、うまくいきませんでした。そして、なぜですか？私たちのプロジェクトはJava 8で作成されました。java-versionコマンドを使用して、サーバー上にあるJavaを確認できます。ほとんどの場合、6または7です。

しかし、失望しないように、新しいバージョンを設定します。

 sudo add-apt-repository ppa:webupd8team/java sudo apt-get update sudo apt-get install oracle-java8-installer

今ではpostgresの番です。その前に、開発者のマシンでローカルバージョンを使用しました。今度は、DBMSをサーバーに配置します。

これを行うには、まずコマンドのマジックシーケンスを実行します。

 sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt/ $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list' sudo apt-get install wget ca-certificates wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add - sudo apt-get update sudo apt-get upgrade sudo apt-get install postgresql-9.4 postgresql-contrib-9.4

postgresを実行します。

 sudo service postgresql start

次に、psql loginコマンドを実行します。

 sudo -u postgres psql

パスワードを設定します。

 \password postgres

そして、\ qコマンドを使用して終了します

ファイル/etc/postgresql/9.4/main/postgresql.confを編集し、行#listen_addresses = 'localhost'をlisten_addresses = '*'に変更します
したがって、pgadminを使用して外部からpostgresqlに接続できます。もちろん、セキュリティ上の理由からこれを回避することをお勧めします。すべてが設定およびデバッグされたら、この機能を無効にします。

次に、ファイル/etc/postgresql/9.4/main/pg_hba.confを編集します
次のように、2つの新しい行を追加し、127.0.0.1の1行を変更する必要があります。

 host all all 127.0.0.1/32 trust host all all <ip- >/32 trust host all all <ip-  >/32 trust

私は個人的にプロジェクトの起動に問題があり、それによって与えられたアドレスのパスワード検証を無効にしているため、md5を信頼するように意図的に変更しました。持っていないかもしれません。

これですべてが設定されました。 postgresを無限に調整することはできますが、小さなプロジェクトしかないため、今のところはそのままにします。

postgresを再起動します。

  sudo service postgresql restart

その動作を確認します。

postgresのセットアップで、すべてが完了しました。スクリプトの次は何ですか？

前述のように、java -jar youapp.jarコマンドで、組み立てられたjarを実行できます。
ただし、このような起動では、外部からサイトにアクセスするには、ポート（デフォルトでは8080）を登録する必要があります。ユーザーがアドレスを入力するだけでサイトにアクセスできるように、プロキシサーバーが必要です。事前設定が必要なnginxを使用することは可能です。

nginxをインストールします。

 sudo apt-get install nginx

私の場合、nginxのルートディレクトリは/ etc / nginxでした。そこで、最初に/ sites_available / defaultファイルを次のように変更する必要があります。

 server { listen 80; server_name youapp.com; location / { proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Forwarded-Server $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_pass http://127.0.0.1:8080/; } }

ただし、これだけではありません。また、私たちが設定したプロキシをサポートするようにプロジェクトを修正する必要があります。幸い、これを行うのは難しくありません。application.propertiesに行を追加するだけです（変更を新しいバージョンに入力することを忘れないでください）。

 server.tomcat.remote_ip_header=x-forwarded-for server.tomcat.protocol_header=x-forwarded-proto

これで、service nginx startコマンドを使用してnginxを起動し、プロジェクトを開始できます。サイトリンクで利用できます。ドメインをまだ購入していない場合は、ポートを指定せずにそのIPアドレスで利用できます。

もう1つ小さなタッチがあります。上記の方法でプロジェクトを常に開始するのは少し不便です。プロジェクトの開始時に、サーバーの入力コンソールが解放され、sshセッションを終了した後にアプリケーションが閉じず、アプリケーションログがどこかに保存されていると便利です。これは、nohupコマンドを使用して実行できます。最初に、bashスクリプトを作成し、script.shを呼び出します。

 #!/bin/bash java -jar youapp.jar

パフォーマンスに対する権利を規定します。

 chmod +x ./script.sh

そして、コマンドを実行します：

 nohup ./start.sh > log.txt 2>&1 &

すべて、アプリケーションが実行されています。

アプリケーションを停止するには、pkill -9 javaコマンド（これがサーバー上で実行されている唯一のJavaアプリケーションである場合）を使用するか、htopユーティリティを使用してこのプロセスを強調表示し、F9ボタンを押して、リストの左側のSIGKILLを選択してEnterキーを押します。注：初めて動作しない場合があり、手順を繰り返す必要があります。

さて、すべてが正しく行われていれば、プロジェクトのサイトをブラウザで開いて結果を楽しむことができます。

PS何も見逃していないことを願っています。間違いを見つけた場合は、個人的なメッセージでこれについて書いてください。テキストはすぐに修正されます。

スプリングブート：開始から運用まで

More articles: