APIとアプリケーションの間でオブジェクトを共有するためのパターン

私のWebアプリケーションの設計について深刻な疑いがあります。

ビジネスロジックをインターフェイスから分離したかったので、データベースへのすべての要求を処理するWeb APIを作成しました。

これは、エンティティフレームワークと作業ユニットおよび汎用リポジトリパターンを備えたASP.NET Web APIです。これまでのところ、すべてが良好です。

問題

ヘルプが必要なのは、APIとアプリケーションの間でオブジェクトを共有する効率的な方法がわからない場合です。

エンティティオブジェクトを直接シリアル化したくありません。エンティティモデルが変更された場合、理由もなく大きなオブジェクトをシリアル化してしまう可能性があるため、これは悪い習慣だと思いました。

現在どのように実装されているか

インターフェイスはC＃のASP.NET Webアプリケーションであり、APIはC＃であるため、共有したいすべてのクラスの定義を含む共通ライブラリを作成しました。

私はAndroidアプリを開発するときにソリューションが機能しないことを知っています。Javaでクラスを再度作成する必要がありますが、それは私の最大の問題ではありません。

問題は、常にオブジェクトを変換しているような気がすることです。

例

これが私のワークフローの例です：

すべてのオブジェクトとフォームのデータ注釈を含むモデルから始め、ユーザーはそのモデルをコントローラーにPOSTします。

コントローラーでは、このモデルを共通ライブラリーのクラスに変換してから、そのオブジェクトをAPIに送信する必要があります。

次に、私のAPIのコントローラーが呼び出しをキャッチし、そのオブジェクトをエンティティオブジェクトに変換して、データベースを更新します。

だから私は3つのクラスを持っています

1. 検証用のすべてのデータ注釈を含むビューのモデル（クライアント）
2. オブジェクトを共有するための共通ライブラリクラス（DLL）
3. エンティティークラス（API）

何か間違ったことをしているような気がします。よりエレガントなものはありますか？プロジェクトが大きくなりすぎる前に、この問題に対する適切な解決策があることを確認したいと思います。

データベースオブジェクト、データ転送オブジェクト、検証ロジックを備えたクライアントオブジェクトなどの間で、常にオブジェクトを前後に変換しているように見えるかもしれませんが、いいえ、あなたは何も間違っていません。

これらの各オブジェクトは、同じ情報単位を表す場合がありますが、責任は大きく異なります。データベースオブジェクトは、データベースとの通信インターフェイスであり、データベースメタデータアノテーションやデータベース実装に関する不必要な詳細が含まれている場合とそうでない場合があるため、データベースレイヤーに保持する必要があります。

データ転送オブジェクトは、APIコンシューマーとの通信インターフェースです。異なる言語/プラットフォームから簡単に利用できるように、これらはできるだけクリーンである必要があります。これにより、サポートするAPIコンシューマーに応じて、これらの外観と動作に特定の制限が課される場合があります。

検証ロジックを備えたクライアントオブジェクトは、実際にはAPIプロジェクトの一部ではなく、コンシューマープロジェクトの一部です。これらは、サーバーが何も知らない（そして何も知らないはずの）クライアント固有のロジック（この場合は検証属性）を追加するため、この場合のデータ転送オブジェクトと同じにすることはできません。これらのオブジェクトは実際にはないため、APIの一部としてカウントします。これらは非常にコンシューマーアプリケーションに固有であり、APIを使用する一部のアプリケーションは実際にはこれらのオブジェクトを作成する必要すらなく、データ転送オブジェクトだけで存続することもできます。たとえば、検証の必要がない場合は、データ転送オブジェクトと完全に同一であるオブジェクトの追加レイヤーは必要ありません。

私には、3つのオブジェクトタイプのそれぞれが、明確なコーディングと優れた実践である単一の責任に非常にうまく対応しているようです。悲しいことに、クリーンなコードと優れたプラクティスは、多くの追加のコードを記述し、「単に」という理由で追加のフープを飛び越えていることを意味します。そしてコーディング中、これがあなたに与える価値を理解するのは難しいかもしれません-しかし、あなたがアプリケーションをリリースし、それをサポートし始めるか、次のバージョンのために新しい機能を追加するやいなや、あなたはおそらくあなたが時間をかけたことに感謝し始めるでしょう。そもそもこれらの懸念を適切に分離してください。（言うまでもなく、

このような異なるオブジェクトタイプ間の変換コードを書くのも嫌いですが、私の解決策は通常、次のいずれかです。

• オブジェクト変換の大部分を行うライブラリを使用してください。たとえば、C＃を使用している場合は、素晴らしいAutoMapperライブラリ（http://automapper.org/）を使用できます。このようなライブラリは他にもいくつかあると思いますが、AutoMapperはこれまでに見た中で最も強力なライブラリです。
• オブジェクトの変換に役立つライブラリが見つからない場合は、それらの間で変換するためのユーティリティメソッドのセットを記述します。これはひどいかもしれませんが、長い目で見ればそれだけの価値があります。何かを初めて変換する必要があるときに変換メソッドを記述してください-待ってはいけません。