// ================================================================================================
//
// ユニットテスト支援用クラスソース。
//
//
// Copyright (C) 2012 Honeplus. All rights reserved.
//
// Honeplus
// ================================================================================================
namespace Honememo.Tests
{
using System;
using System.Collections.Generic;
using System.Reflection;
using Microsoft.VisualStudio.TestTools.UnitTesting;
///
/// ユニットテスト用に private, protected といった外部からアクセスできないメソッドを実行するためのクラス。
/// クラス・オブジェクトに被せるように使用する。
///
/// ラップするオブジェクトのクラス。
/// 使い方については、概ねJUnitのPrivateAccessorと同じようなイメージ。
public class PrivateAccessor
{
#region private変数
///
/// オブジェクトを生成する際に使用するコンストラクタ。
///
private ConstructorInfo constructor;
///
/// テストするメソッド。
///
private MethodInfo method;
#endregion
#region コンストラクタ
///
/// 指定されたオブジェクトをテストするためのインスタンスを生成。
///
/// オブジェクト。
public PrivateAccessor(T obj)
{
this.Instance = obj;
}
///
/// 新しいオブジェクトをテストするためのインスタンスを生成。
///
public PrivateAccessor()
{
}
#endregion
#region プロパティ
///
/// テストする/したクラスのオブジェクト。
///
public T Instance
{
get;
set;
}
#endregion
#region メソッド
///
/// テストするクラスのコンストラクタを指定する。
///
/// パラメータ配列。
/// コンストラクタの確保に失敗した場合は、にてテストを失敗させる。
public void SetConstructor(params Type[] parameterTypes)
{
try
{
// 指定されたコンストラクタを取得
this.constructor = typeof(T).GetConstructor(
BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance,
null,
parameterTypes,
null);
if (this.constructor == null)
{
// メソッド取得失敗のためテスト失敗
Assert.Fail("Constructor is not found");
}
}
catch (Exception e)
{
// メソッド指定誤り、アクセス不可も含め全てテスト失敗
Assert.Fail(e.Message);
}
}
///
/// テストするクラスのオブジェクトを指定されたパラメータで生成する。
///
/// コンストラクタ呼び出しに引数として渡すオブジェクトの配列。
/// このオブジェクトが表すコンストラクタを呼び出すことで作成される新規オブジェクト。
///
/// コンストラクタには、で指定されたメソッドを用いる。
/// 指定されていない場合は、デフォルトコンストラクタを使用する。
/// オブジェクトの生成に失敗した場合は、にてテストを失敗させる。
///
public T NewInstance(params object[] initargs)
{
try
{
// コンストラクタが指定されておらず、パラメータも0件の場合
if (this.constructor == null
&& (initargs == null || initargs.Length == 0))
{
// デフォルトコンストラクタを使用する
this.SetConstructor();
}
// 指定されているコンストラクタでオブジェクトを生成
this.Instance = (T)this.constructor.Invoke(initargs);
// 生成したオブジェクトを返す
return this.Instance;
}
catch (TargetInvocationException e)
{
// コンストラクタが例外を投げる場合は、そのまま返す
throw e.InnerException;
}
catch (Exception e)
{
// オブジェクトが生成できない場合、テスト失敗
Assert.Fail(e.Message);
// failの時点で処理は終了する、コンパイルエラー抑止
throw new Exception("Accessor error", e);
}
}
///
/// テストするメソッドを指定する。
///
/// メソッドの名前。
/// パラメータ配列。
/// メソッドの確保に失敗した場合は、にてテストを失敗させる。
public void SetMethod(string name, params Type[] parameterTypes)
{
try
{
// 指定されたメソッドを取得
this.method = typeof(T).GetMethod(
name,
BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static,
null,
parameterTypes,
null);
if (this.method == null)
{
// メソッド取得失敗のためテスト失敗
Assert.Fail(name + " is not found");
}
}
catch (Exception e)
{
// メソッド指定誤り、アクセス不可も含め全てテスト失敗
Assert.Fail(e.Message);
}
}
///
/// 指定されているメソッドを実行する。
///
/// メソッド呼び出しに使用される引数。
/// このオブジェクトが表すメソッドを、パラメータを使用して実行した結果。
///
/// staticメソッド以外の場合必要な呼び出し元オブジェクトには、
/// または
/// で指定されたオブジェクトを用いる。
/// 指定されていない場合は、可能であればデフォルトコンストラクタでオブジェクトを生成する。
/// メソッドの実行に失敗した場合は、にてテストを失敗させる。
///
public object Invoke(params object[] args)
{
try
{
// オブジェクトが指定されておらず、非staticメソッドの場合
if (this.Instance == null && !this.method.IsStatic)
{
// デフォルトコンストラクタでオブジェクトを作成する
// ※ コンストラクタが指定されている場合、例外
this.NewInstance();
}
// 指定されているオブジェクトでメソッドを実行
return this.method.Invoke(this.Instance, args);
}
catch (TargetInvocationException e)
{
// メソッドが例外を投げる場合は、そのまま返す
throw e.InnerException;
}
catch (Exception e)
{
// メソッド未設定、型違いも含めて全てテスト失敗
Assert.Fail(e.Message);
// failの時点で処理は終了する、コンパイルエラー抑止
throw new Exception("Accessor error", e);
}
}
///
/// テストする/したクラスのオブジェクトより、指定されたフィールドの値を返す。
///
/// フィールド名。
/// フィールドの値。
/// 値の取得に失敗した場合は、にてテストを失敗させる。
public object GetField(string name)
{
try
{
// 指定されたフィールドを取得
FieldInfo field = typeof(T).GetField(
name,
BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static);
if (field == null)
{
// メソッド取得失敗のためテスト失敗
Assert.Fail(name + " is not found");
}
// 指定された値をフィールドから取得する
return field.GetValue(this.Instance);
}
catch (Exception e)
{
// フィールド指定誤り、アクセス不可、オブジェクト無しも含め全てテスト失敗
Assert.Fail(e.Message);
// failの時点で処理は終了する、コンパイルエラー抑止
throw new Exception("Accessor error", e);
}
}
///
/// テストするクラスのオブジェクトで、指定されたフィールドに値を設定する。
///
/// フィールド名。
/// 新しいフィールド値。
///
/// staticフィールド以外の場合に必要な設定先オブジェクトには、
/// または
/// で指定されたオブジェクトを用いる。
/// 指定されていない場合は、可能であればデフォルトコンストラクタでオブジェクトを生成する。
/// 値の設定に失敗した場合は、にてテストを失敗させる。
///
public void SetField(string name, object value)
{
try
{
// 指定されたフィールドを取得
FieldInfo field = typeof(T).GetField(
name,
BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static);
if (field == null)
{
// メソッド取得失敗のためテスト失敗
Assert.Fail(name + " is not found");
}
// オブジェクトが指定されておらず、非staticフィールドの場合
if (this.Instance == null && !field.IsStatic)
{
// デフォルトコンストラクタでオブジェクトを作成する
// ※ コンストラクタが指定されている場合、例外
this.NewInstance();
}
// 指定された値をフィールドに設定する
field.SetValue(this.Instance, value);
}
catch (Exception e)
{
// フィールド指定誤り、アクセス不可も含め全てテスト失敗
Assert.Fail(e.Message);
}
}
///
/// テストする/したクラスのオブジェクトより、指定されたプロパティの値を返す。
///
/// プロパティ名。
/// インデックスプロパティの場合のインデックス。
/// プロパティの値。
/// 値の取得に失敗した場合は、にてテストを失敗させる。
public object GetProperty(string name, params object[] index)
{
try
{
// 指定されたプロパティを取得
PropertyInfo property = typeof(T).GetProperty(
name,
BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
if (property == null)
{
// メソッド取得失敗のためテスト失敗
Assert.Fail(name + " is not found");
}
// 指定された値をプロパティから取得する
return property.GetValue(this.Instance, index);
}
catch (Exception e)
{
// プロパティ指定誤り、アクセス不可、オブジェクト無しも含め全てテスト失敗
Assert.Fail(e.Message);
// failの時点で処理は終了する、コンパイルエラー抑止
throw new Exception("Accessor error", e);
}
}
///
/// テストするクラスのオブジェクトで、指定されたプロパティに値を設定する。
///
/// プロパティ名。
/// 新しいプロパティ値。
/// インデックスプロパティの場合のインデックス。
///
/// 設定先オブジェクトにはまたは
/// で指定されたオブジェクトを用いる。
/// 指定されていない場合は、可能であればデフォルトコンストラクタでオブジェクトを生成する。
/// 値の設定に失敗した場合は、にてテストを失敗させる。
///
public void SetProperty(string name, object value, params object[] index)
{
try
{
// 指定されたプロパティを取得
PropertyInfo property = typeof(T).GetProperty(
name,
BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
if (property == null)
{
// メソッド取得失敗のためテスト失敗
Assert.Fail(name + " is not found");
}
// オブジェクトが指定されていない場合
if (this.Instance == null)
{
// デフォルトコンストラクタでオブジェクトを作成する
// ※ コンストラクタが指定されている場合、例外
this.NewInstance();
}
// 指定された値をプロパティに設定する
property.SetValue(this.Instance, value, index);
}
catch (TargetInvocationException e)
{
// メソッドが例外を投げる場合は、そのまま返す
throw e.InnerException;
}
catch (Exception e)
{
// プロパティ指定誤り、アクセス不可も含め全てテスト失敗
Assert.Fail(e.Message);
}
}
#endregion
}
}