<div class="page"> <div class="cover text-center"> <img class="mx-auto" src=/itb/images/logo_mislata.png alt="logo"> # Documentació Cercle <div class="text-end fit-content ms-auto my-3 mt-auto pt-3"> <p><strong>Autor:</strong> Joan Puigcerver Ibáñez</p> <p><strong>Correu electrònic:</strong> j.puigcerveribanez@edu.gva.es</p> <p><strong>Curs:</strong> 2024/2025</p> </div> <div> <p class="fw-bold mb-0">Llicència: BY-NC-SA</p> <p class="d-none d-md-block">(Reconeixement - No Comercial - Compartir Igual)</p> <a href="https://creativecommons.org/licenses/by-nc-sa/4.0/deed.ca" target="_blank"> <img class="mx-auto" src="/itb/images/license.png" alt="Licence"/> </a> </div><!--license--> </div><!--cover--> </div><!--page--> {:toc} ## Introducció En aquest exercici anem a generar la documentació de la classe `Cercle`. Posteriorment, aquesta documentació serà publicada mitjançant GitHub Pages. ## Tasca A partir de l'exemple: [Generació de la documentació de la classe `Rectangle`](/itb/DAM-ED/UD6/examples/01_javadoc.html) ### Implementació Crea la classe `ud6.examples.Cercle`:  ##### Atributs - `radius`: Radi del cercle - `x`: Posició del centre del cercle en l'eix X - `y`: Posició del centre del cercle en l'eix Y ##### Constructors - `Cercle(double radius, double x, double y)`: Constructor que especifica tots els atributs. - `Cercle(double radius)`: Constructor que especifica el radi i posiciona el cercle en (0, 0). ##### Mètodes: - Getters i setters dels atributs. - `double area()`: Calcula l'àrea del cercle. ??? spoiler L'àrea d'un cercle és: $A = \pi r^2$ ??? - `boolean contains(double x, double y)`: Comprova si el punt especificat (x, y) està dins del cercle. ??? spoiler Un punt està dins del cercle si la distància entre el punt i el centre del cercle es ménor o igual que el radi. La distància entre dos punts $p_1 = (x_1, y_1)$ i $p_2 = (x_2, y_2)$ és: $$d(p_1, p_2) = \sqrt{(x_1 - x_2)^2 + (y_1 - y_2)^2}{}$$ ??? ### Documentació Genera la documentació de la classe `Cercle` i publica-la mitjançant GitHub Pages. ### Tests Crea una classe de tests `ud6.examples.CercleTest` que comprove el correcte funcionament de la classe `Cercle`.