FOSRestBundle dodaje 'S' Get URL

Question

// MySomethingController.php

// look no s 
public function getSomethingAction($args) 
{ 
    ... 
} 

// routing.yml

my_something: 
    type:  rest 
    resource: Blah\Bundle\BlahBundle\Controller\MySomethingController 

trwania:

php app/console router:debug 

wyjściowa:

[router] Current routes 
Name    Method  Pattern 
get_something  GET  /somethings/{args}.{_format} 

Dlaczego trasa "cosbings" (liczba mnoga z "s") zamiast "coś"?

Czy to ustawienie mam gdzieś? czy jest to oczekiwane?

Answer 1

po wykopaniu w kodzie:

• https://github.com/FriendsOfSymfony/FOSRestBundle/blob/master/Routing/Loader/Reader/RestActionReader.php

Oto ona:

private function generateUrlParts(array $resources, array $arguments) 
{ 
    $urlParts = array(); 
    foreach ($resources as $i => $resource) { 
     // if we already added all parent routes paths to URL & we have 
     // prefix - add it 
     if (!empty($this->routePrefix) && $i === count($this->parents)) { 
      $urlParts[] = $this->routePrefix; 
     } 

     // if we have argument for current resource, then it's object. 
     // otherwise - it's collection 
     if (isset($arguments[$i])) { 
      if (null !== $resource) { 
       $urlParts[] = 
        strtolower(Pluralization::pluralize($resource)) 
        .'/{'.$arguments[$i]->getName().'}'; 
      } else { 
       $urlParts[] = '{'.$arguments[$i]->getName().'}'; 
      } 
     } elseif (null !== $resource) { 
      $urlParts[] = strtolower($resource); 
     } 
    } 

    return $urlParts; 
} 

Mam otwarty problem:

• https://github.com/FriendsOfSymfony/FOSRestBundle/issues/247

w nadziei, że będzie to stały się opcjonalne

Answer 2

Ta aktualizacja jest odpowiedzią na podstawie biletu otwartego @phillpafford.

Ismith77 commented na bilecie i pomyślałem wyjaśnione bardzo dobrze dlaczego:

Bez liczby mnogiej nie wiedzielibyśmy relacji między metod, które będzie ważne na przykład przy wdrażaniu # 52. ponadto jest to kluczowa idea REST, że mamyGET dla pojedynczego elementu w kolekcji być w "subdir" z samej kolekcji .

Więc jeśli nie „właściwego” REST następnie /member/{id}.{_format} byłoby dziwnie nazwie ale byłoby naprawdę źle, jeśli kolekcja sama nie będzie wtedy również rezydować w/członka {. format}.

Istota tego wszystkiego polega na tym, że rozwiązanie to nie tyle samo wygoda, co egzekwowanie przestrzegania zasad REST .

PS: Jednak chciałbym podkreślić, że gdy masz słowo jak „danych”, które jest w liczbie mnogiej na jego właścicielem jest nieco irytujące ...