Терминология - пользователи класса - PullRequest
1 голос
/ 25 июля 2010

Я пишу документацию и просто не могу найти правильное слово. Допустим, мой класс называется Writer, и некоторые люди будут его использовать. Как мне назвать объекты, которые используют класс (или экземпляры), который я документирую?

  • Пользователи класса Writer? - Программа не является "пользователем".
  • Потребители класса Writer? - Похоже, кто-нибудь съест это.
  • Абоненты или класс Writer? - Звучит хорошо только для методов.

Должно быть правильное слово для этого, и я должен чувствовать глупость спрашивать, но, пожалуйста, помогите.

Редактировать: просто чтобы прояснить, я думаю о коде (не программист), который вызывает и использует класс или его экземпляр (ну, может быть, я много в коде ...)

Ответы [ 4 ]

3 голосов
/ 25 июля 2010

Я предпочитаю пользователя в любом случае, даже если он не конечный пользователь.Когда вы пишете документацию для своего кода, целевая аудитория - программист, который будет использовать ваш код.Этот программист и его программы пользователи вашего кода.

3 голосов
/ 25 июля 2010

Как насчет "Клиента"?

0 голосов
/ 25 июля 2010

Что ж, в классической книге Мышление в Java 2-е издание есть два способа использования класса: по составу или по наследованию. (Да, этот бит также важен)

Я не помню точных слов, но резюме будет примерно таким:

композиция - вы создаете новый объект, из которого будет ссылаться на экземпляр целевого класса.

наследование - вы создаете новый класс, который наследует (расширяет) целевой класс при условии, что этот класс может быть унаследован от.

Что касается точной терминологии, я бы сказал, что на самом деле это не имеет большого значения.

Но если вы хотите просто описать случай, когда создается новый экземпляр такого класса, вы можете сказать, что какой-то субъект (пользователь) создает экземпляр нового объекта этого класса.

Надеюсь, это поможет.

Отредактировано: терминология действительно зависит, если вы думаете, что пользователь или код пользователя использует целевой класс.

0 голосов
/ 25 июля 2010

Прежде всего, знайте, что нет глупых вопросов, просто глупые ответы.

Конечный пользователь (в данном случае разработчик) будет пользователем класса.
«Глагол» - это глагол, связанный с получением ресурсов.
На самом деле вызов для функций.

...