Convenzioni di denominazione con servizio Web/WCF e nessun sovraccarico

Question

Attualmente hanno il compito di progettare un servizio Web (sto andando a wcf ma i principi continuano ad essere applicati) in C#. Il problema è che non ci sono sovraccarichi di metodi di cui sono a conoscenza, quindi ho bisogno di nominare metodi web con nomi diversi.

Mi piacerebbe un po 'di input sulle convenzioni di denominazione, non sembra proprio che ci sia qualcosa là fuori, per esempio.

Il mio metodo principale è GetMortgages() - che restituisce tutti i mutui. Ho bisogno di un altro in cui restituirà ipoteche entro un determinato intervallo di prezzo, quindi cosa consiglieresti per questo GetMorgagesPriceRange, InPriceRange, WithPriceRange.

Sono po 'confuso circa le migliori pratiche fro denominazione metodi web, mi piacerebbe sovraccaricare solo GetMortgages ma, naturalmente, con i servizi web non posso ...

Quindi sarebbe meglio fare GetNounDesciption ??

Qualcuno sa di eventuali buoni webservices là fuori che ha un metodo che è lo stesso, ma ogni metodo ha diversi parametri passati - piace molto sapere niente qui

Se fare pratica per iniziare il mio WebMethod con GET, se è qualcosa che restituisce qualcosa ??

Che dire di qualcosa che salva e invia qualcosa, c'è uno standard qui ?? cioè PUT o SAVE ???

Ci deve essere una sorta di libro di regole da seguire ??

piacerebbe davvero alcuni input è qualcuno ha qualche

Grazie Mark

Answer 1

Non c'è davvero alcun "regola libro" per le convenzioni di denominazione. Ne trovi uno che funziona per te.

L'adozione più comune con .Net è seguire le convenzioni di denominazione Microsoft .Net e, con i servizi Web, trattarli come un'estensione dell'assembly, non come caso speciale.

http://msdn.microsoft.com/en-us/library/ms229045.aspx

Quindi, GetMortgages(), GetMortgagesInPriceRange (startPrice, endPrice), ecc ... va bene.

Per quanto riguarda il "salvataggio", molte persone useranno il "SubmitNoun".

Answer 2

Penso che tu stia bene. Descrivili in base a ciò che stanno facendo. GetAllMortgages(), GetMortgagesInPriceRange(), ecc.

Prendere in considerazione qualsiasi terminologia specifica del dominio. Ad esempio, se il termine del settore ipotecario per una fascia di prezzo di un mutuo fosse stato "Demografico", allora GetMortgagesForDemographic sarebbe il nome migliore, anche se si sa che le uniche caratteristiche "demografiche" sono la fascia di prezzo.

Answer 3

Si potrebbe andare con il repository-modello, se si dispone di un servizio di repository-simile (come suppongo dai vostri esempi avete) convenzione

GetXByY(params) 

Answer 4

Inoltre, probabilmente si dovrebbe evitare di sovraccaricare i metodi di servizi Web. Usa nomi di metodi distinti.

Answer 5

Si può anche utilizzare il metodo di servizio GetMortgages() per prendere un "documento" anziché i parametri e progettare i criteri di filtro facoltativi nel documento. In questo modo hai un solo metodo che gestisce tutti gli 'overload'.

<GetMortgages> 
    <filter> .... </filter> 
    <sort> .... </sort> 
    <group> .... </group> 
</GetMortgages>