EUDEMON ODATA

What is eudemon odata ?

eudemon odata is an API development framework for building standardized, OData V4 based RESTful services on java ecosystem.

What is OData?

OData stands for the Open Data Protocol. It was initiated by Microsoft and is now an ISO ratified OASIS standard. OData enables the creation and consumption of REST APIs, which allow resources, identified using URLs and defined in a data model, to be published and edited by Web clients using simple HTTP requests.

For more information about OData, please refer to the following resources:

• OData.org
• OASIS Open Data Protocol (OData) Technical Committee

For how to adopt this and related libraries to build OData server, please refer to the Getting Started

Requirements

1. Spring data
2. Query dsl plugin
3. Installed JDK 8 or higher
4. database driver

Getting Started

Add eudemon odata starter to your Maven project:

                <dependency>
                        <groupId>fr.cloverconsulting</groupId>
                        <artifactId>eudemon-odata-starter</artifactId>
                        <version>${eudemon.version}</version>
                </dependency>           
          

add now querydsl dependencies (for more details see querydsl github)

create a spring boot project for more help you can use spring initialzer or start from our sample projects ##sample code

sample entity

@Entity(name="user")
@Table(name = "user")
@Getter
@Setter
public class User implements Serializable {
    @Id
    @Column(name = "myid")
    Integer myid;
    @Column(name = "firstname")
    String firstname;
    @Column(name = "lastname")
    String lastname ;
    @OneToMany(mappedBy = "user",cascade = CascadeType.ALL)
    Set<Adress> adress;
    @Embedded
    Job fonction;

}

spring data repository

add your repository interface and extends OdataExecutor User repositry interface

public interface UserRepository extends JpaRepository<User,String> , OdataExecutor<User> {

}

configuration

Add the following parameters into application.yml file

odata:
  namespace: cloverconsulting
  path: "myendpoint/v1"

Start your server.

Enjoy :)

Support

• Issues: Report issues on Github issues.
• Questions: Ask questions on Stack Overflow.
• Feedback: Please send mails to aayar@cloverconsulting.fr.