JAVA-12419 Renamed apache-cxf to apache-cxf-modules

apache-cxf-modules/README.md

@@ -0,0 +1,9 @@
+## Apache CXF
+
+This module contains articles about Apache CXF
+
+## Relevant Articles:
+
+- [Apache CXF Support for RESTful Web Services](https://www.baeldung.com/apache-cxf-rest-api)
+- [A Guide to Apache CXF with Spring](https://www.baeldung.com/apache-cxf-with-spring)
+- [Introduction to Apache CXF](https://www.baeldung.com/introduction-to-apache-cxf)

apache-cxf-modules/cxf-aegis/README.md

@@ -0,0 +1,3 @@
+### Relevant Articles:
+
+- [Introduction to Apache CXF Aegis Data Binding](https://www.baeldung.com/aegis-data-binding-in-apache-cxf)

apache-cxf-modules/cxf-aegis/pom.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>cxf-aegis</artifactId>
+    <name>cxf-aegis</name>
+
+    <parent>
+        <groupId>com.baeldung</groupId>
+        <artifactId>apache-cxf-modules</artifactId>
+        <version>0.0.1-SNAPSHOT</version>
+    </parent>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.apache.cxf</groupId>
+            <artifactId>cxf-rt-databinding-aegis</artifactId>
+            <version>${cxf.version}</version>
+        </dependency>
+    </dependencies>
+
+</project>

apache-cxf-modules/cxf-aegis/src/main/java/com/baeldung/cxf/aegis/Course.java

@@ -0,0 +1,42 @@
+package com.baeldung.cxf.aegis;
+
+import java.util.Date;
+
+public class Course {
+    private int id;
+    private String name;
+    private String instructor;
+    private Date enrolmentDate;
+
+    public int getId() {
+        return id;
+    }
+
+    public void setId(int id) {
+        this.id = id;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public String getInstructor() {
+        return instructor;
+    }
+
+    public void setInstructor(String instructor) {
+        this.instructor = instructor;
+    }
+
+    public Date getEnrolmentDate() {
+        return enrolmentDate;
+    }
+
+    public void setEnrolmentDate(Date enrolmentDate) {
+        this.enrolmentDate = enrolmentDate;
+    }
+}

apache-cxf-modules/cxf-aegis/src/main/java/com/baeldung/cxf/aegis/CourseRepo.java

@@ -0,0 +1,11 @@
+package com.baeldung.cxf.aegis;
+
+import java.util.Map;
+
+public interface CourseRepo {
+    String getGreeting();
+    void setGreeting(String greeting);
+    Map<Integer, Course> getCourses();
+    void setCourses(Map<Integer, Course> courses);
+    void addCourse(Course course);  
+}

apache-cxf-modules/cxf-aegis/src/main/java/com/baeldung/cxf/aegis/CourseRepoImpl.java

@@ -0,0 +1,34 @@
+package com.baeldung.cxf.aegis;
+
+import java.util.HashMap;
+import java.util.Map;
+
+public class CourseRepoImpl implements CourseRepo {
+    private String greeting;
+    private Map<Integer, Course> courses = new HashMap<>();
+
+    @Override
+    public String getGreeting() {
+        return greeting;
+    }
+
+    @Override
+    public void setGreeting(String greeting) {
+        this.greeting = greeting;
+    }
+
+    @Override
+    public Map<Integer, Course> getCourses() {
+        return courses;
+    }
+
+    @Override
+    public void setCourses(Map<Integer, Course> courses) {
+        this.courses = courses;
+    }
+
+    @Override
+    public void addCourse(Course course) {
+        courses.put(course.getId(), course);
+    }
+}

apache-cxf-modules/cxf-aegis/src/main/resources/com/baeldung/cxf/aegis/Course.aegis.xml

@@ -0,0 +1,5 @@
+<mappings>
+    <mapping>
+        <property name="instructor" ignore="true"/>
+    </mapping>
+</mappings>

apache-cxf-modules/cxf-aegis/src/main/resources/com/baeldung/cxf/aegis/CourseRepo.aegis.xml

@@ -0,0 +1,5 @@
+<mappings xmlns:ns="http://courserepo.baeldung.com">
+    <mapping name="ns:Baeldung">
+        <property name="greeting" style="attribute"/>
+    </mapping>
+</mappings>

apache-cxf-modules/cxf-aegis/src/main/resources/logback.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
+        <encoder>
+            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n
+            </pattern>
+        </encoder>
+    </appender>
+
+    <root level="INFO">
+        <appender-ref ref="STDOUT" />
+    </root>
+</configuration>

apache-cxf-modules/cxf-aegis/src/test/java/com/baeldung/cxf/aegis/BaeldungIntegrationTest.java

@@ -0,0 +1,103 @@
+package com.baeldung.cxf.aegis;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertNull;
+
+import org.junit.After;
+import org.junit.Test;
+
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.lang.reflect.Type;
+import java.util.Date;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.Map;
+import java.util.Set;
+import javax.xml.namespace.QName;
+import javax.xml.stream.XMLInputFactory;
+import javax.xml.stream.XMLOutputFactory;
+import javax.xml.stream.XMLStreamReader;
+import javax.xml.stream.XMLStreamWriter;
+
+import org.apache.cxf.aegis.AegisContext;
+import org.apache.cxf.aegis.AegisReader;
+import org.apache.cxf.aegis.AegisWriter;
+import org.apache.cxf.aegis.type.AegisType;
+
+public class BaeldungIntegrationTest {
+    private AegisContext context;
+    private String fileName = "baeldung.xml";
+
+    @Test
+    public void whenMarshalingAndUnmarshalingCourseRepo_thenCorrect() throws Exception {
+        initializeContext();
+        CourseRepo inputRepo = initCourseRepo();
+        marshalCourseRepo(inputRepo);
+        CourseRepo outputRepo = unmarshalCourseRepo();
+        Course restCourse = outputRepo.getCourses().get(1);
+        Course securityCourse = outputRepo.getCourses().get(2);
+        assertEquals("Welcome to Beldung!", outputRepo.getGreeting());
+        assertEquals("REST with Spring", restCourse.getName());
+        assertEquals(new Date(1234567890000L), restCourse.getEnrolmentDate());
+        assertNull(restCourse.getInstructor());
+        assertEquals("Learn Spring Security", securityCourse.getName());
+        assertEquals(new Date(1456789000000L), securityCourse.getEnrolmentDate());
+        assertNull(securityCourse.getInstructor());
+    }
+    
+    private void initializeContext() {
+        context = new AegisContext();
+        Set<Type> rootClasses = new HashSet<Type>();
+        rootClasses.add(CourseRepo.class);
+        context.setRootClasses(rootClasses);
+        Map<Class<?>, String> beanImplementationMap = new HashMap<>();
+        beanImplementationMap.put(CourseRepoImpl.class, "CourseRepo");
+        context.setBeanImplementationMap(beanImplementationMap);
+        context.setWriteXsiTypes(true);
+        context.initialize();
+    }
+    
+    private CourseRepoImpl initCourseRepo() {
+        Course restCourse = new Course();
+        restCourse.setId(1);
+        restCourse.setName("REST with Spring");
+        restCourse.setInstructor("Eugen");
+        restCourse.setEnrolmentDate(new Date(1234567890000L));
+        Course securityCourse = new Course();
+        securityCourse.setId(2);
+        securityCourse.setName("Learn Spring Security");
+        securityCourse.setInstructor("Eugen");
+        securityCourse.setEnrolmentDate(new Date(1456789000000L));
+        CourseRepoImpl courseRepo = new CourseRepoImpl();
+        courseRepo.setGreeting("Welcome to Beldung!");
+        courseRepo.addCourse(restCourse);
+        courseRepo.addCourse(securityCourse);
+        return courseRepo;
+    }
+    
+    private void marshalCourseRepo(CourseRepo courseRepo) throws Exception {
+        AegisWriter<XMLStreamWriter> writer = context.createXMLStreamWriter();
+        AegisType aegisType = context.getTypeMapping().getType(CourseRepo.class);
+        XMLStreamWriter xmlWriter = XMLOutputFactory.newInstance().createXMLStreamWriter(new FileOutputStream(fileName));
+        writer.write(courseRepo, new QName("http://aegis.cxf.baeldung.com", "baeldung"), false, xmlWriter, aegisType);
+        xmlWriter.close();
+    }
+
+    private CourseRepo unmarshalCourseRepo() throws Exception {       
+        AegisReader<XMLStreamReader> reader = context.createXMLStreamReader();
+        XMLStreamReader xmlReader = XMLInputFactory.newInstance().createXMLStreamReader(new FileInputStream(fileName));
+        CourseRepo courseRepo = (CourseRepo) reader.read(xmlReader, context.getTypeMapping().getType(CourseRepo.class));
+        xmlReader.close();
+        return courseRepo;
+    }
+
+    @After
+    public void cleanup(){
+        File testFile = new File(fileName);
+        if (testFile.exists()) {
+           testFile.delete();     
+        }
+    }
+}

apache-cxf-modules/cxf-introduction/README.md

@@ -0,0 +1,2 @@
+### Relevant Articles:
+- [Introduction to Apache CXF](http://www.baeldung.com/introduction-to-apache-cxf)

apache-cxf-modules/cxf-introduction/pom.xml

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>cxf-introduction</artifactId>
+    <name>cxf-introduction</name>
+
+    <parent>
+        <groupId>com.baeldung</groupId>
+        <artifactId>apache-cxf-modules</artifactId>
+        <version>0.0.1-SNAPSHOT</version>
+    </parent>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.apache.cxf</groupId>
+            <artifactId>cxf-rt-frontend-jaxws</artifactId>
+            <version>${cxf.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.cxf</groupId>
+            <artifactId>cxf-rt-transports-http-jetty</artifactId>
+            <version>${cxf.version}</version>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>exec-maven-plugin</artifactId>
+                <configuration>
+                    <mainClass>com.baeldung.cxf.introduction.Server</mainClass>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>

apache-cxf-modules/cxf-introduction/src/main/java/com/baeldung/cxf/introduction/Baeldung.java

@@ -0,0 +1,16 @@
+package com.baeldung.cxf.introduction;
+
+import java.util.Map;
+
+import javax.jws.WebService;
+import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter;
+
+@WebService
+public interface Baeldung {
+    public String hello(String name);
+
+    public String helloStudent(Student student);
+
+    @XmlJavaTypeAdapter(StudentMapAdapter.class)
+    public Map<Integer, Student> getStudents();
+}

apache-cxf-modules/cxf-introduction/src/main/java/com/baeldung/cxf/introduction/BaeldungImpl.java

@@ -0,0 +1,24 @@
+package com.baeldung.cxf.introduction;
+
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+import javax.jws.WebService;
+
+@WebService(endpointInterface = "com.baeldung.cxf.introduction.Baeldung")
+public class BaeldungImpl implements Baeldung {
+    private Map<Integer, Student> students = new LinkedHashMap<Integer, Student>();
+
+    public String hello(String name) {
+        return "Hello " + name;
+    }
+
+    public String helloStudent(Student student) {
+        students.put(students.size() + 1, student);
+        return "Hello " + student.getName();
+    }
+
+    public Map<Integer, Student> getStudents() {
+        return students;
+    }
+}

apache-cxf-modules/cxf-introduction/src/main/java/com/baeldung/cxf/introduction/Server.java

@@ -0,0 +1,15 @@
+package com.baeldung.cxf.introduction;
+
+import javax.xml.ws.Endpoint;
+
+public class Server {
+    public static void main(String args[]) throws InterruptedException {
+        BaeldungImpl implementor = new BaeldungImpl();
+        String address = "http://localhost:8080/baeldung";
+        Endpoint.publish(address, implementor);
+        System.out.println("Server ready...");
+        Thread.sleep(60 * 1000);
+        System.out.println("Server exiting");
+        System.exit(0);
+    }
+}

apache-cxf-modules/cxf-introduction/src/main/java/com/baeldung/cxf/introduction/Student.java

@@ -0,0 +1,8 @@
+package com.baeldung.cxf.introduction;
+
+import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter;
+
+@XmlJavaTypeAdapter(StudentAdapter.class)
+public interface Student {
+    public String getName();
+}

apache-cxf-modules/cxf-introduction/src/main/java/com/baeldung/cxf/introduction/StudentAdapter.java

@@ -0,0 +1,16 @@
+package com.baeldung.cxf.introduction;
+
+import javax.xml.bind.annotation.adapters.XmlAdapter;
+
+public class StudentAdapter extends XmlAdapter<StudentImpl, Student> {
+    public StudentImpl marshal(Student student) throws Exception {
+        if (student instanceof StudentImpl) {
+            return (StudentImpl) student;
+        }
+        return new StudentImpl(student.getName());
+    }
+
+    public Student unmarshal(StudentImpl student) throws Exception {
+        return student;
+    }
+}

apache-cxf-modules/cxf-introduction/src/main/java/com/baeldung/cxf/introduction/StudentImpl.java

@@ -0,0 +1,23 @@
+package com.baeldung.cxf.introduction;
+
+import javax.xml.bind.annotation.XmlType;
+
+@XmlType(name = "Student")
+public class StudentImpl implements Student {
+    private String name;
+
+    StudentImpl() {
+    }
+
+    public StudentImpl(String name) {
+        this.name = name;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+}

apache-cxf-modules/cxf-introduction/src/main/java/com/baeldung/cxf/introduction/StudentMap.java

@@ -0,0 +1,39 @@
+package com.baeldung.cxf.introduction;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import javax.xml.bind.annotation.XmlElement;
+import javax.xml.bind.annotation.XmlType;
+
+@XmlType(name = "StudentMap")
+public class StudentMap {
+    private List<StudentEntry> entries = new ArrayList<StudentEntry>();
+
+    @XmlElement(nillable = false, name = "entry")
+    public List<StudentEntry> getEntries() {
+        return entries;
+    }
+
+    @XmlType(name = "StudentEntry")
+    public static class StudentEntry {
+        private Integer id;
+        private Student student;
+
+        public void setId(Integer id) {
+            this.id = id;
+        }
+
+        public Integer getId() {
+            return id;
+        }
+
+        public void setStudent(Student student) {
+            this.student = student;
+        }
+
+        public Student getStudent() {
+            return student;
+        }
+    }
+}

apache-cxf-modules/cxf-introduction/src/main/java/com/baeldung/cxf/introduction/StudentMapAdapter.java

@@ -0,0 +1,27 @@
+package com.baeldung.cxf.introduction;
+
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+import javax.xml.bind.annotation.adapters.XmlAdapter;
+
+public class StudentMapAdapter extends XmlAdapter<StudentMap, Map<Integer, Student>> {
+    public StudentMap marshal(Map<Integer, Student> boundMap) throws Exception {
+        StudentMap valueMap = new StudentMap();
+        for (Map.Entry<Integer, Student> boundEntry : boundMap.entrySet()) {
+            StudentMap.StudentEntry valueEntry = new StudentMap.StudentEntry();
+            valueEntry.setStudent(boundEntry.getValue());
+            valueEntry.setId(boundEntry.getKey());
+            valueMap.getEntries().add(valueEntry);
+        }
+        return valueMap;
+    }
+
+    public Map<Integer, Student> unmarshal(StudentMap valueMap) throws Exception {
+        Map<Integer, Student> boundMap = new LinkedHashMap<Integer, Student>();
+        for (StudentMap.StudentEntry studentEntry : valueMap.getEntries()) {
+            boundMap.put(studentEntry.getId(), studentEntry.getStudent());
+        }
+        return boundMap;
+    }
+}

apache-cxf-modules/cxf-introduction/src/main/resources/logback.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
+        <encoder>
+            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n
+            </pattern>
+        </encoder>
+    </appender>
+
+    <root level="INFO">
+        <appender-ref ref="STDOUT" />
+    </root>
+</configuration>

apache-cxf-modules/cxf-introduction/src/test/java/com/baeldung/cxf/introduction/StudentLiveTest.java

@@ -0,0 +1,61 @@
+package com.baeldung.cxf.introduction;
+
+import static org.junit.Assert.assertEquals;
+
+import java.util.Map;
+
+import javax.xml.namespace.QName;
+import javax.xml.ws.Service;
+import javax.xml.ws.soap.SOAPBinding;
+
+import org.junit.Before;
+import org.junit.Test;
+
+public class StudentLiveTest {
+    private static QName SERVICE_NAME = new QName("http://introduction.cxf.baeldung.com/", "Baeldung");
+    private static QName PORT_NAME = new QName("http://introduction.cxf.baeldung.com/", "BaeldungPort");
+
+    private Service service;
+    private Baeldung baeldungProxy;
+    private BaeldungImpl baeldungImpl;
+
+    {
+        service = Service.create(SERVICE_NAME);
+        final String endpointAddress = "http://localhost:8080/baeldung";
+        service.addPort(PORT_NAME, SOAPBinding.SOAP11HTTP_BINDING, endpointAddress);
+    }
+
+    @Before
+    public void reinstantiateBaeldungInstances() {
+        baeldungImpl = new BaeldungImpl();
+        baeldungProxy = service.getPort(PORT_NAME, Baeldung.class);
+    }
+
+    @Test
+    public void whenUsingHelloMethod_thenCorrect() {
+        final String endpointResponse = baeldungProxy.hello("Baeldung");
+        final String localResponse = baeldungImpl.hello("Baeldung");
+        assertEquals(localResponse, endpointResponse);
+    }
+
+    @Test
+    public void whenUsingHelloStudentMethod_thenCorrect() {
+        final Student student = new StudentImpl("John Doe");
+        final String endpointResponse = baeldungProxy.helloStudent(student);
+        final String localResponse = baeldungImpl.helloStudent(student);
+        assertEquals(localResponse, endpointResponse);
+    }
+
+    @Test
+    public void usingGetStudentsMethod_thenCorrect() {
+        final Student student1 = new StudentImpl("Adam");
+        baeldungProxy.helloStudent(student1);
+
+        final Student student2 = new StudentImpl("Eve");
+        baeldungProxy.helloStudent(student2);
+
+        final Map<Integer, Student> students = baeldungProxy.getStudents();
+        assertEquals("Adam", students.get(1).getName());
+        assertEquals("Eve", students.get(2).getName());
+    }
+}

apache-cxf-modules/cxf-jaxrs-implementation/README.md

@@ -0,0 +1,2 @@
+### Relevant Articles:
+- [Apache CXF Support for RESTful Web Services](http://www.baeldung.com/apache-cxf-rest-api)

apache-cxf-modules/cxf-jaxrs-implementation/pom.xml

@@ -0,0 +1,55 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>cxf-jaxrs-implementation</artifactId>
+    <name>cxf-jaxrs-implementation</name>
+
+    <parent>
+        <groupId>com.baeldung</groupId>
+        <artifactId>apache-cxf-modules</artifactId>
+        <version>0.0.1-SNAPSHOT</version>
+    </parent>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.apache.cxf</groupId>
+            <artifactId>cxf-rt-frontend-jaxrs</artifactId>
+            <version>${cxf.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.cxf</groupId>
+            <artifactId>cxf-rt-transports-http-jetty</artifactId>
+            <version>${cxf.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.httpcomponents</groupId>
+            <artifactId>httpclient</artifactId>
+            <version>${httpclient.version}</version>
+            <exclusions>
+                <exclusion>
+                    <artifactId>commons-logging</artifactId>
+                    <groupId>commons-logging</groupId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>exec-maven-plugin</artifactId>
+                <configuration>
+                    <mainClass>com.baeldung.cxf.jaxrs.implementation.RestfulServer</mainClass>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+    <properties>
+        <httpclient.version>4.5.2</httpclient.version>
+    </properties>
+
+</project>

apache-cxf-modules/cxf-jaxrs-implementation/src/main/java/com/baeldung/cxf/jaxrs/implementation/Course.java

@@ -0,0 +1,86 @@
+package com.baeldung.cxf.jaxrs.implementation;
+
+import javax.ws.rs.*;
+import javax.ws.rs.core.Response;
+import javax.xml.bind.annotation.XmlRootElement;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@XmlRootElement(name = "Course")
+public class Course {
+    private int id;
+    private String name;
+    private List<Student> students = new ArrayList<>();
+
+    public int getId() {
+        return id;
+    }
+
+    public void setId(int id) {
+        this.id = id;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public List<Student> getStudents() {
+        return students;
+    }
+
+    public void setStudents(List<Student> students) {
+        this.students = students;
+    }
+
+    @GET
+    @Path("{studentId}")
+    public Student getStudent(@PathParam("studentId") int studentId) {
+        return findById(studentId);
+    }
+
+    @POST
+    public Response createStudent(Student student) {
+        for (Student element : students) {
+            if (element.getId() == student.getId()) {
+                return Response.status(Response.Status.CONFLICT).build();
+            }
+        }
+        students.add(student);
+        return Response.ok(student).build();
+    }
+
+    @DELETE
+    @Path("{studentId}")
+    public Response deleteStudent(@PathParam("studentId") int studentId) {
+        Student student = findById(studentId);
+        if (student == null) {
+            return Response.status(Response.Status.NOT_FOUND).build();
+        }
+        students.remove(student);
+        return Response.ok().build();
+    }
+
+    private Student findById(int id) {
+        for (Student student : students) {
+            if (student.getId() == id) {
+                return student;
+            }
+        }
+        return null;
+    }
+
+    @Override
+    public int hashCode() {
+        return id + name.hashCode();
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        return (obj instanceof Course) && (id == ((Course) obj).getId()) && (name.equals(((Course) obj).getName()));
+    }
+}

apache-cxf-modules/cxf-jaxrs-implementation/src/main/java/com/baeldung/cxf/jaxrs/implementation/CourseRepository.java

@@ -0,0 +1,72 @@
+package com.baeldung.cxf.jaxrs.implementation;
+
+import javax.ws.rs.*;
+import javax.ws.rs.core.Response;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+@Path("baeldung")
+@Produces("text/xml")
+public class CourseRepository {
+    private Map<Integer, Course> courses = new HashMap<>();
+
+    {
+        Student student1 = new Student();
+        Student student2 = new Student();
+        student1.setId(1);
+        student1.setName("Student A");
+        student2.setId(2);
+        student2.setName("Student B");
+
+        List<Student> course1Students = new ArrayList<>();
+        course1Students.add(student1);
+        course1Students.add(student2);
+
+        Course course1 = new Course();
+        Course course2 = new Course();
+        course1.setId(1);
+        course1.setName("REST with Spring");
+        course1.setStudents(course1Students);
+        course2.setId(2);
+        course2.setName("Learn Spring Security");
+
+        courses.put(1, course1);
+        courses.put(2, course2);
+    }
+
+    @GET
+    @Path("courses/{courseId}")
+    public Course getCourse(@PathParam("courseId") int courseId) {
+        return findById(courseId);
+    }
+
+    @PUT
+    @Path("courses/{courseId}")
+    public Response updateCourse(@PathParam("courseId") int courseId, Course course) {
+        Course existingCourse = findById(courseId);
+        if (existingCourse == null) {
+            return Response.status(Response.Status.NOT_FOUND).build();
+        }
+        if (existingCourse.equals(course)) {
+            return Response.notModified().build();
+        }
+        courses.put(courseId, course);
+        return Response.ok().build();
+    }
+
+    @Path("courses/{courseId}/students")
+    public Course pathToStudent(@PathParam("courseId") int courseId) {
+        return findById(courseId);
+    }
+
+    private Course findById(int id) {
+        for (Map.Entry<Integer, Course> course : courses.entrySet()) {
+            if (course.getKey() == id) {
+                return course.getValue();
+            }
+        }
+        return null;
+    }
+}

apache-cxf-modules/cxf-jaxrs-implementation/src/main/java/com/baeldung/cxf/jaxrs/implementation/RestfulServer.java

@@ -0,0 +1,21 @@
+package com.baeldung.cxf.jaxrs.implementation;
+
+import org.apache.cxf.endpoint.Server;
+import org.apache.cxf.jaxrs.JAXRSServerFactoryBean;
+import org.apache.cxf.jaxrs.lifecycle.SingletonResourceProvider;
+
+public class RestfulServer {
+    public static void main(String args[]) throws Exception {
+        JAXRSServerFactoryBean factoryBean = new JAXRSServerFactoryBean();
+        factoryBean.setResourceClasses(CourseRepository.class);
+        factoryBean.setResourceProvider(new SingletonResourceProvider(new CourseRepository()));
+        factoryBean.setAddress("http://localhost:8080/");
+        Server server = factoryBean.create();
+
+        System.out.println("Server ready...");
+        Thread.sleep(60 * 1000);
+        System.out.println("Server exiting");
+        server.destroy();
+        System.exit(0);
+    }
+}

apache-cxf-modules/cxf-jaxrs-implementation/src/main/java/com/baeldung/cxf/jaxrs/implementation/Student.java

@@ -0,0 +1,35 @@
+package com.baeldung.cxf.jaxrs.implementation;
+
+import javax.xml.bind.annotation.XmlRootElement;
+
+@XmlRootElement(name = "Student")
+public class Student {
+    private int id;
+    private String name;
+
+    public int getId() {
+        return id;
+    }
+
+    public void setId(int id) {
+        this.id = id;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    @Override
+    public int hashCode() {
+        return id + name.hashCode();
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        return (obj instanceof Student) && (id == ((Student) obj).getId()) && (name.equals(((Student) obj).getName()));
+    }
+}

apache-cxf-modules/cxf-jaxrs-implementation/src/main/resources/changed_course.xml

@@ -0,0 +1,4 @@
+<Course>
+    <id>2</id>
+    <name>Apache CXF Support for RESTful</name>
+</Course>

apache-cxf-modules/cxf-jaxrs-implementation/src/main/resources/conflict_student.xml

@@ -0,0 +1,4 @@
+<Student>
+    <id>2</id>
+    <name>Student B</name>
+</Student>