Re: Как назвать библиотеку для взаимодействия со сторонним сервисом?
От: Doc Россия http://andrey.moveax.ru
Дата: 07.01.15 14:38
Оценка:
Здравствуйте, Shmj, Вы писали:

S>Можно было бы назвать как AWSApi. Хотя, вроде, тоже не оно, т.к. сама библиотека -- это лишь доп. прослойка для работы с API, а не классы, реализующие API. Или AWSApiClient -- вроде ближе, хотя что такое клиент? Клиент -- это конкретный пользователь, а здесь всего лишь прослойка, часть клиента.


С точки зрения API это как раз клиент. А то ощущение что клиент для вас это исключительно человек.

S>Какое название является наиболее подходящим для такой библиотеки? Что делать, если эта библиотека -- не официальная, т.е. вы как бы не имеете морального права называть ее просто PayPal (т.е. у PayPal может быть своя аналогичная библиотека с их именем)?


Насколько я помню в такой ситуации нельзя "My PayPal SDK", но можно "My SDK for PayPal" (ключевое тут "for")
Re[8]: Как назвать библиотеку для взаимодействия со сторонним сервисом?
От: Shmj Ниоткуда  
Дата: 08.01.15 03:52
Оценка:
Здравствуйте, Qulac, Вы писали:

Q>Клиентский код будет видеть только ваше апи, и ему все равно сколько под ним еще слоев(апи) находится.


Хм. быть может вы и правы. Еще одна обертка над API -- это, в некоторой степени, все равно API.
Re[6]: Как назвать библиотеку для взаимодействия со сторонним сервисом?
От: Shmj Ниоткуда  
Дата: 08.01.15 04:00
Оценка:
Здравствуйте, Sinix, Вы писали:

S>Обычный принцип: Издатель.Технология.Детали. То же имя будет использоваться как namespace, т.е. встречаться десятки раз по всему коду. Также учитываем, что концепция у вас ещё десять раз поменяется от версии к версии, а имя сборки и типов менять слегка некомильфо. Получаем

S>
S>using YourApp.PayPal.Payments;
S>

S>Если в одной библиотеке будут использоваться обёртки для разнотипных сервисов от одной компании — достаточно YourApp.PayPal.

Как назвать общую библиотеку, в которой вспомогательный код для работы с HTTP API разных сервисов (причем не связанных по смыслу)? У ней код маппинга (позволяет получать объект из JSON|XML|CSV с учетом атрибутов полей), базовый класс для объектов, который умеют представлять себя в виде XML|POST-запроса и отправлять по HTTP-протоколу и пр.
Re[2]: Как назвать библиотеку для взаимодействия со сторонним сервисом?
От: Shmj Ниоткуда  
Дата: 08.01.15 04:02
Оценка:
Здравствуйте, netch80, Вы писали:

N>Поскольку слово "интерфейс" во всех его смыслах связано с "лицом", пытаемся подобрать жаргонные термины для последнего. Google подсказывает: muzzle, snout.


Вовсе нет. Ни разу не встречал, чтобы вместо API (application interface), использовали APM или APS. Любям будет не понятно.

А так все знают, что слово интерфейс может относиться как к графическому так и к программному интерфейсу.
Re[2]: Как назвать библиотеку для взаимодействия со сторонним сервисом?
От: Shmj Ниоткуда  
Дата: 08.01.15 04:04
Оценка:
Здравствуйте, Doc, Вы писали:

Doc>С точки зрения API это как раз клиент. А то ощущение что клиент для вас это исключительно человек.


Не человек а вся программа. Браузер -- клиент. Так?

В нашем примере с PayPal клиентом является мобильный клиент вашей разработки, а эта библиотека для облегчения взаимодействия с интерфейсами PayPal -- всего лишь вспомогательной прослойкой.

Doc>Насколько я помню в такой ситуации нельзя "My PayPal SDK", но можно "My SDK for PayPal" (ключевое тут "for")


Что для вас значит SDK? Разве можно такую библиотеку назвать SDK?
Re[3]: Как назвать библиотеку для взаимодействия со сторонним сервисом?
От: Doc Россия http://andrey.moveax.ru
Дата: 08.01.15 05:19
Оценка:
Здравствуйте, Shmj, Вы писали:

S>В нашем примере с PayPal клиентом является мобильный клиент вашей разработки, а эта библиотека для облегчения взаимодействия с интерфейсами PayPal -- всего лишь вспомогательной прослойкой.


Но для PayPal это клиент? Если я запихну браузер в свое приложение и буду брать оттуда DOM он от этого клиентом быть не перестанет ведь. Так?

Doc>>Насколько я помню в такой ситуации нельзя "My PayPal SDK", но можно "My SDK for PayPal" (ключевое тут "for")

S>Что для вас значит SDK? Разве можно такую библиотеку назвать SDK?

Тут не в SDK дело. Я пытался вам показать как можно в принципе назвать библиотку. "My PayPal SDK" нельзя, т.к. вы представляетесь как PayPal, за что настоящий PayPal может законно дать по шее. А вот "My SDK for PayPal" можно, т.к. с "for" указывает для чего библиотека. Замените SDK на то, что вам по вкусу.
Re[7]: Как назвать библиотеку для взаимодействия со сторонним сервисом?
От: . Великобритания  
Дата: 08.01.15 08:14
Оценка:
Здравствуйте, Shmj, Вы писали:

S>Как назвать общую библиотеку, в которой вспомогательный код для работы с HTTP API разных сервисов (причем не связанных по смыслу)? У ней код маппинга (позволяет получать объект из JSON|XML|CSV с учетом атрибутов полей), базовый класс для объектов, который умеют представлять себя в виде XML|POST-запроса и отправлять по HTTP-протоколу и пр.

А я бы такую библиотеку никак не называл, ибо такая библиотека организована как-то странно. А как же SRP? Разбей уж её на разные библиотеки, и проблем не будет с названием.
Надо библиотеки организовывать не по деталям имплементации, а по назначению.
но это не зря, хотя, может быть, невзначай
гÅрмония мира не знает границ — сейчас мы будем пить чай
Re[7]: Как назвать библиотеку для взаимодействия со сторонним сервисом?
От: Sinix  
Дата: 08.01.15 08:51
Оценка:
Здравствуйте, Shmj, Вы писали:

S>Как назвать общую библиотеку, в которой вспомогательный код для работы с HTTP API разных сервисов (причем не связанных по смыслу)? У ней код маппинга (позволяет получать объект из JSON|XML|CSV с учетом атрибутов полей), базовый класс для объектов, который умеют представлять себя в виде XML|POST-запроса и отправлять по HTTP-протоколу и пр.

По описанию — MyApp.MyStuff

Разработчиков абсолютно не интересует, что у библиотеки в кишках. Куда интереснее вопрос, какие проблемы можно решить с помощью этой dll-ки. Вы впихнули в библиотеку всё, поэтому вменяемого имени для неё не получится. Ну обзовите MyApp.WebServices.Client, в описание добавьте, что оно делает на самом деле.
Подождите ...
Wait...
Пока на собственное сообщение не было ответов, его можно удалить.