Существуют ли передовые практики для именования методов и переменных интерфейса SOAP?

Question

В .NET у Microsoft есть рекомендации по именованию классов, членов и т. Д. При разработке библиотек классов. Другие языки также могут иметь лучшие практики, как называть классы, как / если использовать некоторые обозначения.

Теперь SOAP - это протокол, который можно использовать для связи через языковые границы. Есть ли лучшие практики, как называть функции, имена переменных и т. Д.? Или я должен использовать то, что мой язык (если вообще) использует? Или когда я создаю интерфейс SOAP с помощью инструментов (например, контракты на обслуживание WCF), должен ли я использовать то, что производит инструмент?

Answer 1

Официальных соглашений о присвоении имен W3C для имен методов обслуживания не существует.

Некоторые часто используемые рекомендации:

• Имена методов должны четко указывать, что они делают с точки зрения клиента

• Использование разных имен методов вместо перегрузки

• В общем, PascalCasing, кажется, предпочтительнее (без подчеркиваний). Для .Net следуйте соглашениям об именах .Net для обычных методов.

Вы также можете найти эту запись в блоге из Oracle полезной.