| 1. Identificação | ||||||||||
| Tipo de Referência | Tese ou Dissertação (Thesis) | |||||||||
| Site | mtc-m21d.sid.inpe.br | |||||||||
| Código do Detentor | isadg {BR SPINPE} ibi 8JMKD3MGPCW/3DT298S | |||||||||
| Identificador | 8JMKD3MGP3W34T/45DA8DH | |||||||||
| Repositório | sid.inpe.br/mtc-m21d/2021/09.08.19.55 | |||||||||
| Última Atualização | 2021:12.13.18.09.38 (UTC) simone | |||||||||
| Repositório de Metadados | sid.inpe.br/mtc-m21d/2021/09.08.19.55.46 | |||||||||
| Última Atualização dos Metadados | 2022:04.03.23.15.33 (UTC) administrator | |||||||||
| Chave Secundária | INPE-18502-TDI/3149 | |||||||||
| Chave de Citação | Francisco:2021:AsCoAn | |||||||||
| Título | Assessing code annotations usage in software projects  | |||||||||
| Título Alternativo | Avaliando o uso de anotações de código em projetos de software | |||||||||
| Curso | CAP-COMP-DIPGR-INPE-MCTI-GOV-BR | |||||||||
| Ano | 2021 | |||||||||
| Data | 2021-09-16 | |||||||||
| Data de Acesso | 26 abr. 2024 | |||||||||
| Tipo da Tese | Tese (Doutorado em Computação Aplicada) | |||||||||
| Tipo Secundário | TDI | |||||||||
| Número de Páginas | 171 | |||||||||
| Número de Arquivos | 1 | |||||||||
| Tamanho | 10184 KiB | |||||||||
| 2. Contextualização | ||||||||||
| Autor | Francisco, Phyllipe de Souza Lima | |||||||||
| Banca | Stephany, Stephan (presidente) Guerra, Eduardo Martins (orientador) Meirelles, Paulo Roberto Miranda (orientador) Queiroz, Gilberto Ribeiro de Shiguemori, Elcio Hideiti Valente, Marco Tulio Sant’Anna, Cláudio Nogueira | |||||||||
| Endereço de e-Mail | phyllipe_slf@yahoo.com.br | |||||||||
| Universidade | Instituto Nacional de Pesquisas Espaciais (INPE) | |||||||||
| Cidade | São José dos Campos | |||||||||
| Histórico (UTC) | 2021-09-08 19:55:46 :: phyllipe.lima@inpe.br -> administrator :: 2021-09-09 13:51:06 :: administrator -> pubtc@inpe.br :: 2021-09-09 13:51:39 :: pubtc@inpe.br -> phyllipe.lima@inpe.br :: 2021-10-13 21:37:31 :: phyllipe.lima@inpe.br -> pubtc@inpe.br :: 2021-10-18 16:35:24 :: pubtc@inpe.br -> phyllipe.lima@inpe.br :: 2021-10-18 17:09:12 :: phyllipe.lima@inpe.br -> pubtc@inpe.br :: 2021-10-25 16:37:19 :: pubtc@inpe.br -> phyllipe.lima@inpe.br :: 2021-10-25 20:15:47 :: phyllipe.lima@inpe.br -> pubtc@inpe.br :: 2021-12-13 19:00:32 :: pubtc@inpe.br -> simone :: 2021-12-13 19:00:50 :: simone :: -> 2021 2021-12-13 19:00:50 :: simone -> administrator :: 2021 2022-04-03 23:15:33 :: administrator -> :: 2021 | |||||||||
| 3. Conteúdo e estrutura | ||||||||||
| É a matriz ou uma cópia? | é a matriz | |||||||||
| Estágio do Conteúdo | concluido | |||||||||
| Transferível | 1 | |||||||||
| Palavras-Chave | code annotations software metric software visualization polymetric view metadata anotações metadados métricas de software visualização de software visão polimétrica | |||||||||
| Resumo | Code annotation is a language feature that enables the introduction of custom metadata on programming elements. In Java, this feature was introduced on version 5, and it is widely used by the leading enterprise application frameworks and APIs. Although very popular to simplify metadata configuration, software engineering lack research and experiments about them. Also, its abuse and misuse can reduce source code readability, comprehension and complicate its maintenance. Our work proposes an approach to assess code annotations usage and distribution in a software project to overcome this. We begin defining a novel suite of software metrics dedicated to code annotations. We analyzed their distribution in open-source projects by extracting their values from 24,947 java classes and obtaining threshold values.We also provided a way to interpret these threshold values using a percentile rank analysis, revealing outliers. Afterward, we proposed a novel polymetric view tailored specifically to visualize code annotations distribution and usage using our metrics as input. We named it CADV - Code Annotations Distribution Visualization. To validate the CADV, we conducted two experiments. The first was an interview with six professional developers from EMBRACE, and the second was conducted asynchronously with 44 students through a form. As a target software, we used the SpaceWeather system. Our results show that the proposed visualization approach can aid developers and students in comprehending the distribution of code annotations, packages responsibilities and potentially detect misplaced ones. Furthermore, CADV provides a much quicker approach to identify code annotations and schemas when compared with manual code inspection. RESUMO: Anotações de código são uma característica de linguagem que permitem a configuração de metadados em elementos de programação. Na linguagem Java, essa característica foi introduzida na versão 5 e é utilizada por desenvolvedores de frameworks e APIs corporativas amplamente utilizadas. Mesmo que as anotações sejam muito populares para simplificar a configuração de metadados, a comunidade de engenharia de software possui poucos trabalhos que as investigam. Adicionalmente, o seu uso inadequado pode reduzir a legibilidade, compreensão e comprometer a manutenção do sistema. Com isso, esse trabalho apresenta uma abordagem para avaliar o uso e distribuição de anotações em projetos Java. O primeiro passo foi definir um novo conjunto de métricas de código fonte capaz de extrair características das anotações usadas. Para validar as métricas, fizemos uma coleta em 25 projetos de código aberto e foi possível observar como elas se comportam. Em seguida, com as métricas disponíveis, fizemos uma proposta de visualização polimétrica projetada para visualizar anotações de código e como estão distribuídas. Para validar a visualização conduzimos dois experimentos. O primeiro foi feito com seis desenvolvedores que participaram da criação do sistema SpaceWeather do EMBRACE, e o segundo foi conduzido com 44 alunos de graduação. Os resultados mostraram que a visualização permite compreender rapidamente a distribuição das anotações e identificar as responsabilidades dos pacotes. | |||||||||
| Área | COMP | |||||||||
| Arranjo 1 | urlib.net > BDMCI > Fonds > Produção pgr ATUAIS > CAP > Assessing code annotations... | |||||||||
| Arranjo 2 | urlib.net > BDMCI > Fonds > Produção a partir de 2021 > CGIP > Assessing code annotations... | |||||||||
| Conteúdo da Pasta doc | acessar | |||||||||
| Conteúdo da Pasta source |
| |||||||||
| Conteúdo da Pasta agreement |
| |||||||||
| 4. Condições de acesso e uso | ||||||||||
| URL dos dados | http://urlib.net/ibi/8JMKD3MGP3W34T/45DA8DH | |||||||||
| URL dos dados zipados | http://urlib.net/zip/8JMKD3MGP3W34T/45DA8DH | |||||||||
| Idioma | en | |||||||||
| Arquivo Alvo | publicacao.pdf | |||||||||
| Grupo de Usuários | phyllipe.lima@inpe.br pubtc@inpe.br simone | |||||||||
| Visibilidade | shown | |||||||||
| Licença de Direitos Autorais | urlib.net/www/2012/11.12.15.10 | |||||||||
| Permissão de Leitura | allow from all | |||||||||
| Permissão de Atualização | não transferida | |||||||||
| 5. Fontes relacionadas | ||||||||||
| Repositório Espelho | urlib.net/www/2021/06.04.03.40.25 | |||||||||
| Unidades Imediatamente Superiores | 8JMKD3MGPCW/3F2PHGS 8JMKD3MGPCW/46KUES5 | |||||||||
| Lista de Itens Citando | dpi.inpe.br/banon/2004/02.16.09.30.00 2 sid.inpe.br/bibdigital/2013/10.12.22.16 1 | |||||||||
| Acervo Hospedeiro | urlib.net/www/2021/06.04.03.40 | |||||||||
| 6. Notas | ||||||||||
| Campos Vazios | academicdepartment affiliation archivingpolicy archivist callnumber contenttype copyholder creatorhistory descriptionlevel dissemination doi electronicmailaddress format group isbn issn label lineage mark nextedition notes number orcid parameterlist parentrepositories previousedition previouslowerunit progress readergroup resumeid rightsholder schedulinginformation secondarydate secondarymark session shorttitle sponsor subject tertiarymark tertiarytype url versiontype | |||||||||