Duplicate code is one of the most pungent code smells. A rule that is often used is to re-structure code once it is duplicated in three or more places.
Common duplication problems, and corresponding solutions are:
1 | <?php |
||
32 | class RouteController extends FOSRestController |
||
33 | { |
||
34 | /** |
||
35 | * Lists current tenant routes. |
||
36 | * |
||
37 | * @ApiDoc( |
||
38 | * resource=true, |
||
39 | * description="Lists current tenant routes", |
||
40 | * statusCodes={ |
||
41 | * 200="Returned on success." |
||
42 | * } |
||
43 | * ) |
||
44 | * @Route("/api/{version}/content/routes/", options={"expose"=true}, defaults={"version"="v1"}, name="swp_api_content_list_routes") |
||
45 | * @Method("GET") |
||
46 | * |
||
47 | * @Cache(expires="10 minutes", public=true) |
||
48 | */ |
||
49 | View Code Duplication | public function listAction(Request $request) |
|
|
|||
50 | { |
||
51 | $routeRepository = $this->get('swp.repository.route'); |
||
52 | |||
53 | $routes = $routeRepository->getPaginatedByCriteria(new Criteria(), [], new PaginationData($request)); |
||
54 | |||
55 | return $this->handleView(View::create($this->get('swp_pagination_rep')->createRepresentation($routes, $request), 200)); |
||
56 | } |
||
57 | |||
58 | /** |
||
59 | * Show single tenant route. |
||
60 | * |
||
61 | * @ApiDoc( |
||
62 | * resource=true, |
||
63 | * description="Show single tenant route", |
||
64 | * statusCodes={ |
||
65 | * 200="Returned on success." |
||
66 | * } |
||
67 | * ) |
||
68 | * @Route("/api/{version}/content/routes/{id}", options={"expose"=true}, defaults={"version"="v1"}, name="swp_api_content_show_routes", requirements={"id"=".+"}) |
||
69 | * @Method("GET") |
||
70 | * |
||
71 | * @Cache(expires="10 minutes", public=true) |
||
72 | */ |
||
73 | 1 | public function getAction($id) |
|
74 | { |
||
75 | 1 | return $this->handleView(View::create($this->findOr404($id), 200)); |
|
76 | } |
||
77 | |||
78 | /** |
||
79 | * Delete single tenant route. |
||
80 | * |
||
81 | * @ApiDoc( |
||
82 | * resource=true, |
||
83 | * description="Delete single tenant route", |
||
84 | * statusCodes={ |
||
85 | * 204="Returned on success." |
||
86 | * } |
||
87 | * ) |
||
88 | * @Route("/api/{version}/content/routes/{id}", options={"expose"=true}, defaults={"version"="v1"}, name="swp_api_content_delete_routes", requirements={"id"=".+"}) |
||
89 | * @Method("DELETE") |
||
90 | */ |
||
91 | 1 | public function deleteAction($id) |
|
106 | |||
107 | /** |
||
108 | * Creates routes for current tenant. |
||
109 | * |
||
110 | * Parameter `type` cane have one of two values: `content` or `collection`. |
||
111 | * |
||
112 | * @ApiDoc( |
||
113 | * resource=true, |
||
114 | * description="Create new route", |
||
115 | * statusCodes={ |
||
116 | * 201="Returned on success.", |
||
117 | * 400="Returned when not valid data." |
||
118 | * }, |
||
119 | * input="SWP\Bundle\ContentBundle\Form\Type\RouteType" |
||
120 | * ) |
||
121 | * @Route("/api/{version}/content/routes/", options={"expose"=true}, defaults={"version"="v1"}, name="swp_api_content_create_routes") |
||
122 | * @Method("POST") |
||
123 | */ |
||
124 | 24 | View Code Duplication | public function createAction(Request $request) |
145 | |||
146 | /** |
||
147 | * Updates routes for current tenant. |
||
148 | * |
||
149 | * Parameter `type` cane have one of two values: `content` or `collection`. |
||
150 | * |
||
151 | * @ApiDoc( |
||
152 | * resource=true, |
||
153 | * description="Update single route", |
||
154 | * statusCodes={ |
||
155 | * 200="Returned on success.", |
||
156 | * 400="Returned when not valid data.", |
||
157 | * 404="Returned when not found.", |
||
158 | * 409="Returned on conflict." |
||
159 | * }, |
||
160 | * input="SWP\Bundle\ContentBundle\Form\Type\RouteType" |
||
161 | * ) |
||
162 | * @Route("/api/{version}/content/routes/{id}", options={"expose"=true}, defaults={"version"="v1"}, name="swp_api_content_update_routes", requirements={"id"=".+"}) |
||
163 | * @Method("PATCH") |
||
164 | */ |
||
165 | 5 | View Code Duplication | public function updateAction(Request $request, $id) |
184 | |||
185 | 6 | private function findOr404($id) |
|
193 | |||
194 | 24 | private function ensureRouteExists($name) |
|
200 | } |
||
201 |
Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.
You can also find more detailed suggestions in the “Code” section of your repository.