C# & JavaScript

Git for Windows をインストールする手順をまとめてみました。 GitHub を利用するときは GitHub for Windows があるので今まで Git の公式アプリ を使うことはありませんでした。 今回、 Bower を利用しようとした際、 Git がないとダウンロードできないので、インストールしてみる運びとなったので、ついでにまとめることにしました。

目次

• Git とは
• ダウンロード
• インストール
• 動作確認

Git とは

ソースコード管理システムの１つです。 ソースコード管理システムでは、ファイルの作成者や作成日時、変更者、変更日時、変更点などを管理できます。

ソースコード管理システムだと SVN が有名かと思いますが、SVN (集中型バージョン管理)と Git (分散型バージョン管理) ではソースコードの修正方法が異なります。 集中型バージョン管理では、リポジトリからチェックアウトして修正し、修正が完了するとマージしてコミット（チェックイン）します。 分散型バージョン管理では、リポジトリからフォーク（プル）してローカルリポジトリを作成し、そこに対して修正を行い、リモートリポジトリにプッシュしてマージを行います。

ダウンロード

Git for Windows の GitHub ページへ移動します。 ダウンロードするインストーラは自動判別してくれているので気にせず「Download」で大丈夫です。

1. Git for Windows の GitHub ページへ移動

   https://git-for-windows.github.io/

   

2. [Download] を選択

   

過去バージョンや他ビットコンパイルのものをダウンロードしたい場合、GitHub の リリースページ (以下のリンク) からダウンロードできます。

• https://github.com/git-for-windows/git/releases

インストール

インストーラーを起動して指示に従って進めていきます。

1. 記載されているライセンス条項 を確認して [Next] を選択。

   

2. インストール先ディレクトリを指定して [Next] を選択

   

3. 追加オプションを選択して [Next] を選択

   個人的にはどのオプションも不要なのですべて外しました。

   

4. スタートメニューへ追加するフォルダ名を指定して [Next] を選択

   スタートメニューに追加しない場合、[Don't create a Start Menu foler] を選択して [Next] を選択

   

5. PATH環境変数の設定。 Unix系のツールは使わず Windows の コマンドプロンプト だけで利用しようと思いますので、 "Use Git form the Windows Command Prompt" を選択して [Next] を選択

   

6. 改行コードの制御設定。 Git 機能に任せず エディタ側 で制御したいので 何も手を加えない "Checkout as-is, commit as-is" を選択して [Next] を選択

   

7. Git Bash を実行するターミナル。 Windows標準の コマンドプロンプト を利用するので "Use Windows' default console window" を選択して [Next] を選択

   

8. その他オプション。 ファイルキャッシュ、証明書管理は使いそうなのでとりあえずチェックした状態のまま [Install] を選択

   

9. インストールが始まるのでしばらく待つ

   

10. 完了画面では Git Bash の起動 および リリースノートの確認 ともに行わないので チェック を外して [Finish] を選択

    

動作確認

Windows標準 の コマンドプロンプト を利用するので コマンドプロンプト を立ち上げて確認します。

1. git --version を実行

   

参考記事

• OPC Diary - 私家版 Git For Windowsのインストール手順

Windows マシン で Node.js および npm を利用できるようにする手順をまとめました。 ちなみに… Node.js は 「サーバーで動くJavaScript」で ミドルウェア にあたるもので、npm は 「パッケージ管理ツール」です。

目次

• インストーラー の ダウンロード
• インストール
• 動作確認

インストーラー の ダウンロード

まずは Node.js のサイトへ移動してインストーラーを取得します。

• Node.js の ダウンロードページ へ 移動

  https://nodejs.org/en/download/

  

• ダウンロード する バージョン を選択

  どうしても使いたい機能がある等でなければ、"LTS" で良いと思います。

  LTS

  Long-term Support。新規機能追加はなく、バグフィックスやセキュリティアップデートを行う長期サポート版。

  Current

  最新版。新規機能等が使える。

  

• 使っているOSと同じビット版を選択

  

インストール

上述手順でダウンロードしたインストーラを実行してインストールを始めます。

• ウェルカムページで [Next] を選択

  

• ライセンス条項を確認して 同意チェックボックス をチェックし、[Next] を選択

  

• インストール先を指定して [Next] を選択

  

• インストールするものを選択して [Next] を選択

  基本的にはすべて選択された状態でインストール。

  

• インストール準備画面で [Next] を選択

  

• インストールされるのをしばらく待つ…

  

• インストールが完了したので [Finish] を選択

  

動作確認

上述のインストールが終わると node 、 npm および 環境変数 の設定まで終わっている状態になっています。 以下では コマンドプロンプト を実行して node および npm の動作確認を行います。

• node コマンド が使えることを node --version を実行して確認

  

• npm コマンド が使えることを npm --version を実行して確認

  

Java で作成した Tomcat を利用した Webアプリケーション を WARファイル に固めて デプロイ する方法をまとめておきます。 実運用ではもう少し手が加わりそうですが…、ざっくりとリリース手順のイメージはつかめるかと思います。

目次

• WARファイル作成
• Tomcatへ配置
• 動作確認

WARファイル作成

リリースしたい Webアプリケーション を WARファイル というカタチに固めてしまいます。 このファイルの中には class ファイルだけでなく、 web.xml といった設定ファイルも含まれます。

1. Eclipse を起動して出力したい Webアプリケーション を開く

   

2. 出力したい Webアプリケーション を右クリック、[Export]-[WAR file] を選択

   

3. [Destination] を指定して [Finish] を選択

   

4. 指定した出力先に warファイル が作成される

Tomcatへ配置

Tomcat デフォルト設定であれば、基本的には配置するだけです。

1. 上記 で作成した warファイル を ${CATALINA_HOME}/webapps 直下へ 配置

   

2. 所有権 を Tomcat 実行ユーザー に変更

   

   # cd ${CATALINA_HOME}/webapps/
   # sudo chown tomat:tomcat WebApplication1.war
   

warファイルを置くだけの設定になっているかどうかは server.xml の unpackWARs および autoDeploy を確認します。 以下のサンプルコードを参照。

${CATALINA_HOME}/conf/server.xml

<?xml version='1.0' encoding='utf-8'?>
<Server port="8005" shutdown="SHUTDOWN">
  …
  <Service name="Catalina">
  …
    <Engine name="Catalina" defaultHost="localhost">
    …
      <Host name="localhost"  appBase="webapps"
            unpackWARs="true" autoDeploy="true">
      …
      </Host>
    …
    </Engine>
  </Service>
</Server>

動作確認

動作確認は単純にブラウザを立ち上げて呼び出してみるだけです。

1. ブラウザを立ち上げて Webアプリケーション へアクセス

   

参考記事

• WEB ARCH LABO - CentOS/RedHat に Tomcat 7 をインストールする手順
• WEB ARCH LABO - CentOS/RedHat に Tomcat 7 をインストールする手順
• LinuxサーバへのTomcat 7導入 (Tomcatインストール)

最近の Webアプリケーション であれば ユーザー認証 を必要とするサイトが普通かと思います。 ユーザー認証の仕組みを作るのと同じように必要となるのがコンテンツに対するアクセス制御です。 ここでは コンテンツに対するアクセス制御 の具体的な実装例をまとめます。

目次

• 概要
• web.config で 制御する 方法
• 属性 で 制御する 方法

概要

ユーザー認証が終わると、続いてコンテンツにアクセスして良いかどうかの判断（承認）が行われます。 以下では承認の方法別メリット・デメリットおよび一般的な実装概念について述べます。

手法別メリット・デメリット

具体的なアクセス制御方法ですが、ASP.NET の 承認制御 は 「web.config を用いた方法」 と 「ソースコードに属性として記述する方法」 の２パターンがあります。 それぞれのメリット、デメリットをまとめると以下のようになるかと思います。

• web.config を用いた方法

  メリット

  ソースコード修正なしにアクセス制御の変更が可能な点

  デメリット

  静的コンテンツを含めてあらゆるコンテンツについて制御を考える必要がある点

• ソースコードに属性として記述する方法

  メリット

  アクセス可否判定の実装がロジックのみになるので理解しやすい点

  デメリット

  アクセス制御の変更をしようとするとコンパイルを伴う点

ホワイトリスト形式、ブラックリスト形式

一般的概念の話となりますが、アクセス制御を実装する際の考え方として 「ホワイトリスト形式」 と 「ブラックリスト形式」 があるかと思います。 それぞれ具体的には以下のような制御方法になります。

ホワイトリスト形式

匿名ユーザーからのアクセスを基本的に拒否として許可するコンテンツをリストアップする方法。 コンテンツのほとんどが会員向けである場合、ホワイトリスト形式が良いと思います。

ブラックリスト形式

匿名ユーザーからのアクセスを基本的に許可してアクセスできないコンテンツをリストアップする方法。

web.config で 制御する 方法

web.config で制御する場合、 location 要素と組み合わせることで実現できます。 ホワイトリスト形式で行うのかブラックリスト形式で行くのかで記載は異なりますが、ここではホワイトリスト形式での設定方法を記載します。 ホワイトリスト形式なので、基本的にはアクセス遮断でアクセス許可するコンテンツをリストアップする記載方法になります。

web.config

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <!-- ルート設定(基本設定) -->
  <system.web>
    <authentication mode="Forms">
      <forms loginUrl="/Account/Login" />
    </authentication>
    <authorization>
      <deny users="?"/>
    </authorization>
  </system.web>

  <!-- 静的コンテンツのアクセス許可 -->
  <location allowOverride="true" path="Content">
    <system.web>
      <authorization>
        <allow users="*"/>
      </authorization>
    </system.web>
  </location>

  <!-- ログインページのアクセス許可 -->
  <location allowOverride="true" path="Account/Login">
    <system.web>
      <authorization>
        <allow users="*"/>
      </authorization>
    </system.web>
  </location>

  <!-- Public配下はアクセス許可 -->
  <location allowOverride="true" path="Public">
    <system.web>
      <authorization>
        <allow users="*"/>
      </authorization>
    </system.web>
  </location>
</configuration>

location要素 配下にない 13行目 の allow要素 はこの web.config が配置されているディレクトリ配下に対する設定を示しています。 この指定がデフォルト指定になります。 個別に許可するディレクトリ、パス、ファイルは location要素 を利用して設定していきます。

authorization要素 の 子要素 に指定している allow要素 について、users でよく使う指定には以下の２パターンがあります。

<allow users="*"/>

anonymouse (誰でも) 許可。認証していないユーザーもアクセス可能。

<allow users="?"/>

ユーザー認証されたユーザーのみアクセス許可。

属性 で 制御する 方法

前述の web.config での制御と同様に認証は フォーム認証 としています（以下の web.config 参照）。 承認はソースコード上の属性 AuthorizeAttribute と AllowAnonymousAttribute を用いて行います。 サンプルとして ASP.NET MVC のコントローラでの実装例を以下に載せます。

web.config

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.web>
    <authentication mode="Forms">
      <forms loginUrl="/Account/Login" />
    </authentication>
  </system.web>
</configuration>

SearchController.cs

namespace WebApplication1.Controllers
{
    using System.Web.Mvc;

    [Authorize]
    public class SearchController : Controller
    {
        // GET: Search
        [HttpGet]
        [AllowAnonymous]
        public ActionResult Index()
        {
            return this.View();
        }

        // POST: Search
        [HttpPost]
        public ActionResult Index(string key)
        {
            return this.View();
        }
    }
}

基本的に匿名ユーザーからのアクセスを拒否したいため、クラスに対して Authorize を指定して認証が必要であることを示します （5行目） 。 匿名ユーザーでも利用できる処理（サンプルコード上では GET: Search/Index）については AllowAnonymous を指定してアクセス許可します （10行目）。

セキュリティ上の対策として パラメタライズドクエリ (パラメタ化クエリ、パラメータクエリ等呼ばれています） を利用すると思います。 このパラメタライズドクエリ、言語やデータベースによって指定方法が異なるのが厄介。。

C# で SQL Server に対して パラメタライズドクエリ を利用する際は @パラメータ名 でパラメータ指定します。 Command を再利用する場合、パラメータが保存されたままとなるのでパラメータ指定するキー名が被らないように注意します。

サンプルコード

using System;
using System.Configuration;
using System.Data.SqlClient;

public void Insert1(string id, string password, string role)
{
    // 接続文字列の取得
    var connectionString = ConfigurationManager.ConnectionStrings["sqlsvr"].ConnectionString;

    using (var connection = new SqlConnection(connectionString))
    using (var command = connection.CreateCommand())
    {
        try
        {
            // データベースの接続開始
            connection.Open();

            // SQLの準備
            command.CommandText = @"INSERT INTO T_USER (ID, PASSWORD, ROLE_NAME) VALUES (@ID, @PASSWORD, @ROLE_NAME)";
            command.Parameters.Add(new SqlParameter("@ID", id));
            command.Parameters.Add(new SqlParameter("@PASSWORD", password));
            command.Parameters.Add(new SqlParameter("@ROLE_NAME", role));

            // SQLの実行
            command.ExecuteNonQuery();
        }
        catch (Exception exception)
        {
            Console.WriteLine(exception.Message);
            throw;
        }
        finally
        {
            // データベースの接続終了
            connection.Close();
        }
    }
}

関連記事

C# を使って SQL Server に接続、操作する方法に関しては以下のような記事もあります。 あわせて参考に読んでいただけると理解が深まるハズ！

• SQL Server に 接続
• SQL Server に対して SELECT文 を 実行
• SQL Server に対して INSERT文 ・ UPDATE文 ・ DELETE文 を 実行
• SQL Server に対して パラメタライズドクエリ を 実行 ←この記事

C# で SQL Server に対して変更処理（INSERT, UPDATE, DELETE）を実行する方法をまとめてみました。

１行だけ実行

単一テーブルにしか影響しないようなSQLは１行だけ実行することになると思います。 このようなSQLを実行する場合、トランザクションを考慮せずそのまま ExecuteNonQuery() を実行する方法が簡単です。

using System;
using System.Configuration;
using System.Data.SqlClient;

public void Insert1(string id, string password, string role)
{
    // 接続文字列の取得
    var connectionString = ConfigurationManager.ConnectionStrings["sqlsvr"].ConnectionString;

    using (var connection = new SqlConnection(connectionString))
    using (var command = connection.CreateCommand())
    {
        try
        {
            // データベースの接続開始
            connection.Open();

            // SQLの準備
            command.CommandText = @"INSERT INTO T_USER (ID, PASSWORD, ROLE_NAME) VALUES (@ID, @PASSWORD, @ROLE_NAME)";
            command.Parameters.Add(new SqlParameter("@ID", id));
            command.Parameters.Add(new SqlParameter("@PASSWORD", password));
            command.Parameters.Add(new SqlParameter("@ROLE_NAME", role));

            // SQLの実行
            command.ExecuteNonQuery();
        }
        catch (Exception exception)
        {
            Console.WriteLine(exception.Message);
            throw;
        }
        finally
        {
            // データベースの接続終了
            connection.Close();
        }
    }
}

トランザクション処理

複数テーブルに書き込みを行う場合、トランザクションを利用した書き込みになるかと思います。 通常はこちらの方が多い実装になるかと思います。

using System;
using System.Configuration;
using System.Data.SqlClient;

public void Insert2(string id, string password, string phone, string address)
{
    // 接続文字列の取得
    var connectionString = ConfigurationManager.ConnectionStrings["sqlsvr"].ConnectionString;

    using (var connection = new SqlConnection(connectionString))
    {
        try
        {
            // データベースの接続開始
            connection.Open();

            using (var transaction = connection.BeginTransaction())
            using (var command = new SqlCommand() { Connection = connection, Transaction = transaction })
            {
                try
                {
                    // 親テーブルを挿入するSQLの準備
                    command.CommandText = @"INSERT INTO T_USER (ID, PASSWORD) VALUES (@ID, @PASSWORD)";
                    command.Parameters.Add(new SqlParameter("@ID", id));
                    command.Parameters.Add(new SqlParameter("@PASSWORD", password));

                    // 親テーブルを挿入するSQLの実行
                    command.ExecuteNonQuery();

                    // 子テーブルを挿入するSQLの準備
                    command.CommandText = @"INSERT INTO T_USER_EXT (ID, PHONE, ADDRESS) VALUES (@ID, @PHONE, @ADDRESS)";
                    ////command.Parameters.Add(new SqlParameter("@ID", id));         // <- 上で既に @ID を追加済みのため再投入は不要。
                    command.Parameters.Add(new SqlParameter("@PHONE", phone));
                    command.Parameters.Add(new SqlParameter("@ADDRESS", address));

                    // 子テーブルを挿入するSQLの実行
                    command.ExecuteNonQuery();

                    // コミット
                    transaction.Commit();
                }
                catch
                {
                    // ロールバック
                    transaction.Rollback();
                    throw;
                }
            }
        }
        catch (Exception exception)
        {
            Console.WriteLine(exception.Message);
            throw;
        }
        finally
        {
            // データベースの接続終了
            connection.Close();
        }
    }
}

[おまけ] DB変更を行うSQL

INSERT

INSERT INTO T_USER (
  ID, PASSWORD
) VALUES (
  @ID, @PASSWORD
);

UPDATE

UPDATE T_USER
SET
  PASSWORD=@PASSWORD
WHERE
  ID=@ID
;

DELETE

DELETE
 FROM T_USER
WHERE ID=@ID

関連記事

C# を使って SQL Server に接続、操作する方法に関しては以下のような記事もあります。 あわせて参考に読んでいただけると理解が深まるハズ！

• SQL Server に 接続
• SQL Server に対して SELECT文 を 実行
• SQL Server に対して INSERT文 ・ UPDATE文 ・ DELETE文 を 実行←この記事
• SQL Server に対して パラメタライズドクエリ を 実行

C# で SQL Server に対して SELECT文 を実行する際のサンプルコードを作成しました。 ここでは「SELECT文 の 実行結果 を DataTable へ投入する方法」と「SELECT文 の 実行結果 を １行ずつ読み込んで処理していく方法」の２種類を例として取り上げます。

まとめて読み込む (DataTable)

DataTable へ SELECT文 の 結果 を一括読み込みしてしまう方法です。 単純で理解しやすい方法かと思います。 DataSet へ 結果投入してしまってもよいのですが、DataTable を取り出すためにワンクッション必要となるため、個人的には DataTable へ直接投入で良いかと思います。

まとめて DataTable へ読み込む際は、 DataAdapter を利用します。

using System;
using System.Configuration;
using System.Data;
using System.Data.SqlClient;

public DataTable GetData()
{
    var table = new DataTable();

    // 接続文字列の取得
    var connectionString = ConfigurationManager.ConnectionStrings["sqlsvr"].ConnectionString;

    using (var connection = new SqlConnection(connectionString))
    using (var command = connection.CreateCommand())
    {
        try
        {
            // データベースの接続開始
            connection.Open();

            // SQLの設定
            command.CommandText = @"SELECT count(*) FROM T_USER";

            // SQLの実行
            var adapter = new SqlDataAdapter(command);
            adapter.Fill(table);
        }
        catch (Exception exception)
        {
            Console.WriteLine(exception.Message);
            throw;
        }
        finally
        {
            // データベースの接続終了
            connection.Close();
        }
    }

    return table;
}

１行ずつ読み込む (SqlDataReader)

SELECT の 結果 を１行ずつ読み込む場合、 DataReader を利用します。 Command の ExecuteReader() メソッドを実行することで DataReader を取得し、１行ずつ読み込んで処理を行います。 少し実装は面倒ですが O/Rマッピング のようなことができます。 以下のサンプルコードにおける UserModel は T_USER に対応する独自のクラスになります。

using System;
using System.Collections.Generic;
using System.Configuration;
using System.Data.SqlClient;
using WebApplication1.Models;

public List GetData()
{
    var list = new List();

    // 接続文字列の取得
    var connectionString = ConfigurationManager.ConnectionStrings["sqlsvr"].ConnectionString;

    using (var connection = new SqlConnection(connectionString))
    using (var command = connection.CreateCommand())
    {
        try
        {
            // データベースの接続開始
            connection.Open();

            // SQLの設定
            command.CommandText = @"SELECT ID,PASSWORD,ROLE_NAME FROM T_USER";

            // SQLの実行
            using (var reader = command.ExecuteReader())
            {
                while (reader.Read() == true)
                {
                    list.Add(new UserModel()
                    {
                        Id = reader["ID"] as string,
                        Password = reader["PASSWORD"] as string,
                        RoleName = reader["ROLE_NAME"] as string
                    });
                }
            }
        }
        catch (Exception exception)
        {
            Console.WriteLine(exception.Message);
            throw;
        }
        finally
        {
            // データベースの接続終了
            connection.Close();
        }
    }

    return list;
}

関連記事

C# を使って SQL Server に接続、操作する方法に関しては以下のような記事もあります。 あわせて参考に読んでいただけると理解が深まるハズ！

• SQL Server に 接続
• SQL Server に対して SELECT文 を 実行 ←この記事
• SQL Server に対して INSERT文 ・ UPDATE文 ・ DELETE文 を 実行
• SQL Server に対して パラメタライズドクエリ を 実行