# otaviocx/owl-s-restful architecture

> Architecture diagram of the GitHub repository otaviocx/owl-s-restful, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/otaviocx/owl-s-restful
- Repository: https://github.com/otaviocx/owl-s-restful

## Overview

##### Project type and purpose
- This is an open-source tool/library (packaged with Maven) for processing WADL (Web Application Description Language) documents:
- It parses WADL into an in-memory model
- It can generate Java client/server stubs (Wadl2Java)
- It can produce OWL-S “groundings” for semantic web services (RESTfulGrounding)
- It ships with a set of OWL ontologies and XSLT mappings to drive transformations

##### File structure
- Top‐level
- owl/ – OWL ontologies (RESTfulGrounding, Process, Profile, Service, common vocabularies) and WADL files
- pom.xml – Maven build, dependencies, packaging
- src/main/java
– br.ufg.inf.rest – core WADL model interfaces and implementations (Application, Resource, Request, Parameter)
– br.ufg.inf.sws.rest – OWL-S grounding APIs (WADLGrounding, AtomicGrounding, Factory, Provider) plus implementations
– org.jvnet.ws.wadl – JAXB-backed WADL parser classes (Application, Resource, Method, Param, Representation)
– org.jvnet.ws.wadl2java – code-generation engine (ResourceClassGenerator, Wadl2Java entry point, AST nodes)
- src/main/resources – WADL XSD, Wadl2Java properties, OWLObjectConverterProvider registration
- src/test/java – JUnit tests for Wadl2Java and RESTfulSWS features

##### (empty) README for additional insights
- No README content provided, but the file/folder naming makes the tool’s purpose clear.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "External Inputs"
        WADL["WADL Files"]:::external
        OWL["OWL Ontologies"]:::external
        XSLT["XSLT Mappings"]:::external
    end

    subgraph "Processing Engine"
        subgraph "Parsing"
            Parser["Core WADL Parser"]:::core
        end
        subgraph "Code Generation"
            Generator["Wadl2Java Code Generator"]:::core
        end
        subgraph "Semantic Grounding"
            Grounding["Semantic Web Service Grounding"]:::core
        end
        subgraph "RESTful App Layer"
            RESTApp["RESTful Application Layer"]:::core
        end
        Model["In-Memory Model"]:::core
    end

    subgraph "Build & Packaging"
        Maven["Maven (pom.xml)"]:::core
    end

    subgraph "Outputs"
        JavaArtifacts["Generated Java Artifacts"]:::output
        OWLSOutput["OWL-S Grounding Files"]:::output
    end

    subgraph "Test Suite"
        Test1["Wadl2Java Tests"]:::core
        Test2["RESTful SWS Tests"]:::core
    end

    %% Data Flows
    WADL --> Parser
    OWL --> Grounding
    XSLT --> Grounding
    Parser --> Model
    Model --> Generator
    Model --> Grounding
    Generator --> JavaArtifacts
    Grounding --> OWLSOutput

    %% Build Orchestration
    Maven --> Parser
    Maven --> Generator
    Maven --> Grounding
    Maven --> RESTApp
    Maven --> Test1
    Maven --> Test2

    %% Click Events
    click WADL "https://github.com/otaviocx/owl-s-restful/tree/master/owl/"
    click OWL "https://github.com/otaviocx/owl-s-restful/tree/master/owl/"
    click XSLT "https://github.com/otaviocx/owl-s-restful/blob/master/owl/facebookToFoaf.xslt"
    click Parser "https://github.com/otaviocx/owl-s-restful/tree/master/src/main/java/org/jvnet/ws/wadl"
    click Generator "https://github.com/otaviocx/owl-s-restful/tree/master/src/main/java/org/jvnet/ws/wadl2java"
    click Grounding "https://github.com/otaviocx/owl-s-restful/tree/master/src/main/java/br/ufg/inf/sws/rest"
    click RESTApp "https://github.com/otaviocx/owl-s-restful/tree/master/src/main/java/br/ufg/inf/rest"
    click Maven "https://github.com/otaviocx/owl-s-restful/blob/master/pom.xml"
    click Test1 "https://github.com/otaviocx/owl-s-restful/blob/master/src/test/java/br/ufg/inf/rest/Wadl2JavaTest.java"
    click Test2 "https://github.com/otaviocx/owl-s-restful/blob/master/src/test/java/br/ufg/inf/sws/RESTfulSWSTest.java"

    %% Styles
    classDef external fill:#BBEFFF,stroke:#000,stroke-width:1px;
    classDef core fill:#B2FFB2,stroke:#000,stroke-width:1px;
    classDef output fill:#FFD580,stroke:#000,stroke-width:1px;
```
