質問をすることでしか得られない、回答やアドバイスがある。

15分調べてもわからないことは、質問しよう!

ただいまの
回答率

90.74%

  • Java

    13127questions

    Javaは、1995年にサン・マイクロシステムズが開発したプログラミング言語です。表記法はC言語に似ていますが、既存のプログラミング言語の短所を踏まえていちから設計されており、最初からオブジェクト指向性を備えてデザインされています。セキュリティ面が強力であることや、ネットワーク環境での利用に向いていることが特徴です。Javaで作られたソフトウェアは基本的にいかなるプラットフォームでも作動します。

  • Spring Boot

    444questions

    Spring Bootは、Javaのフレームワークの一つ。Springプロジェクトが提供する様々なフレームワークを統合した、アプリケーションを高速で開発するために設計されたフレームワークです。

理想的なパッケージ構成について

解決済

回答 3

投稿

  • 評価
  • クリップ 1
  • VIEW 4,787

rnosh

score 145

 前書き

ここに質問するのが正しいかはわかりませんが、経験豊富な方々に意見を頂きたく質問します。
タグは今使用している言語・フレームワークにしておきました。

 前提・実現したいこと

現在、ネットワーク構成管理用のWebGUIを作成しています。
チーム事情でWeb系エンジニアが自分一人です。周囲に有識者もいないため、誰かと相談することができない状況です。

現状JavaとSpring bootを用いてWebGUIの設計を行っていますが、私のこれまでの経験では既存システム改修に主に携わってきたこと、パッケージ構成を改善するような大規模改修を行ったことがなく、
またプロジェクトの新規でプロジェクトを立ち上げたことがないので、パッケージ構成について深く考えたことがありませんでした(反省)。

今後、案件としても継続性・拡大性が高いのと、自分が永遠に保守するわけではないので、可能な限りわかりやすいパッケージ構成にしたいと考えています。
もちろんソフトウェア開発の"原則"のようなものはあると思いますが、どうしてもネットの記事や参考書だけでは腑に落ち切らない部分があるので、
有識者の方の経験や、こうあったほうがいいという理想などをお聞き出来たらと思っています。

 考えていること

依存関係や再利用性、変更可能性などを鑑みて設計をしているつもりなのですが、今までに経験のあるパッケージ構成にどうしても寄ってしまいます。
経験の大部分を占める条件および構成の例を以下に記載します。
※あくまで例なので、こういう役割があるべき、増やしたほうがいいなどの観点は排除して頂けたらと思います。

  • 機能群A、機能群Bがあるとする。
  • クラスの役割として、"Controller"、"Form"、"Logic"に分割されている。
package
 ∟hoge
  ∟機能群A
   ∟Controller
   ∟Form
   ∟Logic
  ∟機能群B
   ∟Controller
   ∟Form
   ∟Logic


経験では大体このようなつくりのパッケージ構成が多かったので、初めは何の気なしにこのような構成で設計をスタートさせました。

ただ、もしかしたら、

package
 ∟hoge
  ∟Controller
   ∟機能群A
   ∟機能群B
  ∟Form
   ∟機能群A
   ∟機能群B
  ∟Logic
   ∟機能群A
   ∟機能群B


こういった作りのほうが大部分の現場ではオーソドックスなのではないか?

と考え始めたら、何が一番良いのか見えなくなってきてしまったのが現在地です。

どういったパッケージ管理が理想的なのか、処理でいうところのOCP的なものはあるのかなどを踏まえ、
ご意見を頂けたらと思います。

よろしくお願いします。

  • 気になる質問をクリップする

    クリップした質問は、後からいつでもマイページで確認できます。

    またクリップした質問に回答があった際、通知やメールを受け取ることができます。

    クリップを取り消します

  • 良い質問の評価を上げる

    以下のような質問は評価を上げましょう

    • 質問内容が明確
    • 自分も答えを知りたい
    • 質問者以外のユーザにも役立つ

    評価が高い質問は、TOPページの「注目」タブのフィードに表示されやすくなります。

    質問の評価を上げたことを取り消します

  • 評価を下げられる数の上限に達しました

    評価を下げることができません

    • 1日5回まで評価を下げられます
    • 1日に1ユーザに対して2回まで評価を下げられます

    質問の評価を下げる

    teratailでは下記のような質問を「具体的に困っていることがない質問」、「サイトポリシーに違反する質問」と定義し、推奨していません。

    • プログラミングに関係のない質問
    • やってほしいことだけを記載した丸投げの質問
    • 問題・課題が含まれていない質問
    • 意図的に内容が抹消された質問
    • 広告と受け取られるような投稿

    評価が下がると、TOPページの「アクティブ」「注目」タブのフィードに表示されにくくなります。

    質問の評価を下げたことを取り消します

    この機能は開放されていません

    評価を下げる条件を満たしてません

    評価を下げる理由を選択してください

    詳細な説明はこちら

    上記に当てはまらず、質問内容が明確になっていない質問には「情報の追加・修正依頼」機能からコメントをしてください。

    質問の評価を下げる機能の利用条件

    この機能を利用するためには、以下の事項を行う必要があります。

質問への追記・修正、ベストアンサー選択の依頼

  • asahina1979

    2017/10/12 08:44

    一長一短があるがどちらも正しい構成である。まあパッケージ名は小文字で

    キャンセル

  • asahina1979

    2017/10/12 08:47

    com.example.form.hoge などの形式もある

    キャンセル

回答 3

checkベストアンサー

0

こういう役割があるべき、増やしたほうがいいなどの観点は排除して頂けたら

とのことなので、観点とメリット・デメリットのみを。

前者(機能パッケージ以下にクラスのステレオタイプを並べる方法)は、機能単位で作成しやすい。
1つの機能を作る=Controller/Service/Repositoryを1セット作るので、機能の責務を分けやすい構成だが、Conntroller/Service/Repositoryを必ず1セット作ることになるため、クラスの実数は増える傾向にあるでしょう。
他機能からの参照有無をアクセス修飾子で切りやすい(パッケージプライベートのスコープも使うよう視野に入れられる)

後者(ステレオタイプ以下に機能ごとのクラスを作る)がこちらが採用されているケースが個人的には多いのではと思います。機能別には読みにくい構成にはなりますが、同一ステレオタイプから参照するメソッドが多い場合ならメリットはあるでしょう。

個人的には前者です。

投稿

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

  • 2017/10/16 11:29

    わかりやすいご説明ありがとうございます!
    どちらもメリデメがあるようなので、自分がどういったクラス構成にするのか再度熟考してから決めたいと思います。
    ご意見ありがとうございました!

    キャンセル

0

一例です。
http://terasolunaorg.github.io/guideline/5.3.0.RELEASE/ja/Overview/ApplicationLayering.html#projectname-domain

http://terasolunaorg.github.io/guideline/5.3.0.RELEASE/ja/Overview/ApplicationLayering.html#projectname-web

自分ひとりでならば、好きにやってしまえばと思う。

Eclipse等のIDEを使っていれば、かなり作りこんだ後でも、パッケージ移動で変えることもできるし。

AOP等でクラスに対して何らかするような場合に
・パッケージを列挙する
・クラス名の正規表現パターン
で対応するようなことが今後あると思われる

パッケージよりも、クラス名やクラスの責務に注意して置いた方が良いと思う。
命名 XxxRepository/XxxService/XxxHelper/XxxController ・・・・
責務 コントローラにビジネスロジックを混ぜない、エンティティをextendsしてmodelにしちゃうのはやめた方が良いかと

投稿

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

  • 2017/10/16 11:30

    今は自分一人なんですが、今後人員が増えてきそうなので・・・笑
    責務に関してはご意見の通りですね、今一度認識をし直して考えたいと思います。
    ご意見ありがとうございました!

    キャンセル

0

経験からすると後者のhoge.controller.FuncsionA.classが多いです。

ちょっと脱線しますが、controllerformはUI(またはAPI/REST)が起因になるかと思います。
ただlogicはそれとは切り離して考えたほうがいいです。
ボクは細かい業務レベル(20~30ステップ)かDBへのアクセスを基本として考えるので、
logic内のクラスに関しては機能群Xと異なる粒度になります。
例えば、消費税クラスは税率マスタを参照して、税込・税抜き・税額を計算するlogicクラスなど。
このように簡単に分けれるモノは多くないと思いますが、、、

logicを機能群A,B...単位で作成していくと、
コードが冗長になったり、Utilクラスが長くなったり、
最悪はコードが冗長になったことでabstractクラスにメソッド増やしたり、新規で作ったりし始める人がいるので、
要注意です。

個人的には後者ですが、上手くハイブリットに組み合わせるのも手の1つかと、、、

投稿

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

  • 2017/10/16 11:27

    すみません、Logicクラスに関する扱いは完全にStruts起因でして・・・笑
    ActionとLogic的な発想です。Springに触れ始めてからまだ日が浅いので、例えばSQL実行を行うクラスをSpringでいうとどんな役割に充当すべきなのかまだ迷っていたので、Logicと表現しました。

    ハイブリッドに組み合わせてわかりやすい構成が作れたらよいですね!
    ただ今後の拡大可能性を鑑みてできるだけオーソドックスに行ってみようと思います。
    ご意見ありがとうございました!

    キャンセル

15分調べてもわからないことは、teratailで質問しよう!

  • ただいまの回答率 90.74%
  • 質問をまとめることで、思考を整理して素早く解決
  • テンプレート機能で、簡単に質問をまとめられる

関連した質問

  • 解決済

    emacsにphp-modeをインストールしたい

    emacsにphp-modeをインストールしたく、emacsをversion24.5までアップデートしました。 そして、jquery-master.netここに書いてあるよう

  • 解決済

    input type=submit のvalueを変更する方法について

    いつもお世話になっております。 早速ですが、1点質問が御座います。 只今、フォームを送信したタイミングで、 submitボタンのvalueを「送信完了」に変更するjava

  • 解決済

    CAKEPHP3 Model配下へのビジネスロジックを移行

    PHP初心者です。 CAKEPHP 3.2.1を初めて使用しています。 Windows 8.1のローカル環境にて開発を行っております。 現在、ビジネスロジックをAPP\s

  • 解決済

    Asp.Net MVC ViewからControllerへの値受け渡し

    前提・実現したいこと ここに質問したいことを詳細に書いてください 初めてご質問させて頂きます。初心者ですので、基礎的な質問となってしまうかもしれませんが、お力を頂きたいです

  • 解決済

    パラメータ取得

    Ruby初心者です。 やりたいことは 1ルートとなるindex画面から、フォームにID番号を記入 2検索ボタンを押下 3データベースに保存されているデータを、同じi

  • 解決済

    Golangでhttp.HandleFunc()に登録した関数に値を渡す方法について

    以下のようにhttp.HandleFunc()に登録したhogeパッケージの関数Fuga()へ変数Valの値を渡したいのですが、そのような方法はあるのでしょうか?よろしくお願いしま

  • 受付中

    Springでのパラメータ値の取得

    htmlのフォームに入力した値をcontroller経由でmodelで取得する方法を教えて下さい。 @RequestMapping(value="/hoge2/←フォームのある

  • 解決済

    phpunitでテスト実行時エラーについて

    phpunitを使用してコンポーネントのテストをしたいと考えています。 namespace App\Controller\Component ; use Cake\Contro

同じタグがついた質問を見る

  • Java

    13127questions

    Javaは、1995年にサン・マイクロシステムズが開発したプログラミング言語です。表記法はC言語に似ていますが、既存のプログラミング言語の短所を踏まえていちから設計されており、最初からオブジェクト指向性を備えてデザインされています。セキュリティ面が強力であることや、ネットワーク環境での利用に向いていることが特徴です。Javaで作られたソフトウェアは基本的にいかなるプラットフォームでも作動します。

  • Spring Boot

    444questions

    Spring Bootは、Javaのフレームワークの一つ。Springプロジェクトが提供する様々なフレームワークを統合した、アプリケーションを高速で開発するために設計されたフレームワークです。