DATACMNS-266 - Use new common Maven build infrastructure.

Simplified project setup to be a single module build again. Using Spring Data Build parent POM to simplify project setup. See https://github.com/SpringSource/spring-data-build#spring-data-build-infrastructure

src/main/java/org/springframework/data/domain/Auditable.java

@@ -0,0 +1,87 @@
+/*
+ * Copyright 2008-2010 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.domain;
+
+import java.io.Serializable;
+
+import org.joda.time.DateTime;
+
+/**
+ * Interface for auditable entities. Allows storing and retrieving creation and modification information. The changing
+ * instance (typically some user) is to be defined by a generics definition.
+ * 
+ * @param <U> the auditing type. Typically some kind of user.
+ * @param <ID> the type of the audited type's identifier
+ * @author Oliver Gierke
+ */
+public interface Auditable<U, ID extends Serializable> extends Persistable<ID> {
+
+	/**
+	 * Returns the user who created this entity.
+	 * 
+	 * @return the createdBy
+	 */
+	U getCreatedBy();
+
+	/**
+	 * Sets the user who created this entity.
+	 * 
+	 * @param createdBy the creating entity to set
+	 */
+	void setCreatedBy(final U createdBy);
+
+	/**
+	 * Returns the creation date of the entity.
+	 * 
+	 * @return the createdDate
+	 */
+	DateTime getCreatedDate();
+
+	/**
+	 * Sets the creation date of the entity.
+	 * 
+	 * @param creationDate the creation date to set
+	 */
+	void setCreatedDate(final DateTime creationDate);
+
+	/**
+	 * Returns the user who modified the entity lastly.
+	 * 
+	 * @return the lastModifiedBy
+	 */
+	U getLastModifiedBy();
+
+	/**
+	 * Sets the user who modified the entity lastly.
+	 * 
+	 * @param lastModifiedBy the last modifying entity to set
+	 */
+	void setLastModifiedBy(final U lastModifiedBy);
+
+	/**
+	 * Returns the date of the last modification.
+	 * 
+	 * @return the lastModifiedDate
+	 */
+	DateTime getLastModifiedDate();
+
+	/**
+	 * Sets the date of the last modification.
+	 * 
+	 * @param lastModifiedDate the date of the last modification to set
+	 */
+	void setLastModifiedDate(final DateTime lastModifiedDate);
+}

src/main/java/org/springframework/data/domain/AuditorAware.java

@@ -0,0 +1,32 @@
+/*
+ * Copyright 2008-2010 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.domain;
+
+/**
+ * Interface for components that are aware of the application's current auditor. This will be some kind of user mostly.
+ * 
+ * @param <T> the type of the auditing instance
+ * @author Oliver Gierke
+ */
+public interface AuditorAware<T> {
+
+	/**
+	 * Returns the current auditor of the application.
+	 * 
+	 * @return the current auditor
+	 */
+	T getCurrentAuditor();
+}

src/main/java/org/springframework/data/domain/Page.java

@@ -0,0 +1,120 @@
+/*
+ * Copyright 2008-2010 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.domain;
+
+import java.util.Iterator;
+import java.util.List;
+
+/**
+ * A page is a sublist of a list of objects. It allows gain information about the position of it in the containing
+ * entire list.
+ * 
+ * @param <T>
+ * @author Oliver Gierke
+ */
+public interface Page<T> extends Iterable<T> {
+
+	/**
+	 * Returns the number of the current page. Is always positive and less that {@code Page#getTotalPages()}.
+	 * 
+	 * @return the number of the current page
+	 */
+	int getNumber();
+
+	/**
+	 * Returns the size of the page.
+	 * 
+	 * @return the size of the page
+	 */
+	int getSize();
+
+	/**
+	 * Returns the number of total pages.
+	 * 
+	 * @return the number of toral pages
+	 */
+	int getTotalPages();
+
+	/**
+	 * Returns the number of elements currently on this page.
+	 * 
+	 * @return the number of elements currently on this page
+	 */
+	int getNumberOfElements();
+
+	/**
+	 * Returns the total amount of elements.
+	 * 
+	 * @return the total amount of elements
+	 */
+	long getTotalElements();
+
+	/**
+	 * Returns if there is a previous page.
+	 * 
+	 * @return if there is a previous page
+	 */
+	boolean hasPreviousPage();
+
+	/**
+	 * Returns whether the current page is the first one.
+	 * 
+	 * @return
+	 */
+	boolean isFirstPage();
+
+	/**
+	 * Returns if there is a next page.
+	 * 
+	 * @return if there is a next page
+	 */
+	boolean hasNextPage();
+
+	/**
+	 * Returns whether the current page is the last one.
+	 * 
+	 * @return
+	 */
+	boolean isLastPage();
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see java.lang.Iterable#iterator()
+			 */
+	Iterator<T> iterator();
+
+	/**
+	 * Returns the page content as {@link List}.
+	 * 
+	 * @return
+	 */
+	List<T> getContent();
+
+	/**
+	 * Returns whether the {@link Page} has content at all.
+	 * 
+	 * @return
+	 */
+	boolean hasContent();
+
+	/**
+	 * Returns the sorting parameters for the page.
+	 * 
+	 * @return
+	 */
+	Sort getSort();
+}

src/main/java/org/springframework/data/domain/PageImpl.java

@@ -0,0 +1,255 @@
+/*
+ * Copyright 2008-2010 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.domain;
+
+import java.io.Serializable;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Iterator;
+import java.util.List;
+
+/**
+ * Basic {@code Page} implementation.
+ * 
+ * @param <T> the type of which the page consists.
+ * @author Oliver Gierke
+ */
+public class PageImpl<T> implements Page<T>, Serializable {
+
+	private static final long serialVersionUID = 867755909294344406L;
+
+	private final List<T> content = new ArrayList<T>();
+	private final Pageable pageable;
+	private final long total;
+
+	/**
+	 * Constructor of {@code PageImpl}.
+	 * 
+	 * @param content the content of this page
+	 * @param pageable the paging information
+	 * @param total the total amount of items available
+	 */
+	public PageImpl(List<T> content, Pageable pageable, long total) {
+
+		if (null == content) {
+			throw new IllegalArgumentException("Content must not be null!");
+		}
+
+		this.content.addAll(content);
+		this.total = total;
+		this.pageable = pageable;
+	}
+
+	/**
+	 * Creates a new {@link PageImpl} with the given content. This will result in the created {@link Page} being identical
+	 * to the entire {@link List}.
+	 * 
+	 * @param content
+	 */
+	public PageImpl(List<T> content) {
+
+		this(content, null, (null == content) ? 0 : content.size());
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see org.springframework.data.domain.Page#getNumber()
+			 */
+	public int getNumber() {
+
+		return pageable == null ? 0 : pageable.getPageNumber();
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see org.springframework.data.domain.Page#getSize()
+			 */
+	public int getSize() {
+
+		return pageable == null ? 0 : pageable.getPageSize();
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see org.springframework.data.domain.Page#getTotalPages()
+			 */
+	public int getTotalPages() {
+
+		return getSize() == 0 ? 0 : (int) Math.ceil((double) total / (double) getSize());
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see org.springframework.data.domain.Page#getNumberOfElements()
+			 */
+	public int getNumberOfElements() {
+
+		return content.size();
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see org.springframework.data.domain.Page#getTotalElements()
+			 */
+	public long getTotalElements() {
+
+		return total;
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see org.springframework.data.domain.Page#hasPreviousPage()
+			 */
+	public boolean hasPreviousPage() {
+
+		return getNumber() > 0;
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see org.springframework.data.domain.Page#isFirstPage()
+			 */
+	public boolean isFirstPage() {
+
+		return !hasPreviousPage();
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see org.springframework.data.domain.Page#hasNextPage()
+			 */
+	public boolean hasNextPage() {
+
+		return ((getNumber() + 1) * getSize()) < total;
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see org.springframework.data.domain.Page#isLastPage()
+			 */
+	public boolean isLastPage() {
+
+		return !hasNextPage();
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see org.springframework.data.domain.Page#iterator()
+			 */
+	public Iterator<T> iterator() {
+
+		return content.iterator();
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see org.springframework.data.domain.Page#asList()
+			 */
+	public List<T> getContent() {
+
+		return Collections.unmodifiableList(content);
+	}
+
+	/*
+		 * (non-Javadoc)
+		 *
+		 * @see org.springframework.data.domain.Page#hasContent()
+		 */
+	public boolean hasContent() {
+
+		return !content.isEmpty();
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see org.springframework.data.domain.Page#getSort()
+			 */
+	public Sort getSort() {
+
+		return pageable == null ? null : pageable.getSort();
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see java.lang.Object#toString()
+			 */
+	@Override
+	public String toString() {
+
+		String contentType = "UNKNOWN";
+
+		if (content.size() > 0) {
+			contentType = content.get(0).getClass().getName();
+		}
+
+		return String.format("Page %s of %d containing %s instances", getNumber(), getTotalPages(), contentType);
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see java.lang.Object#equals(java.lang.Object)
+			 */
+	@Override
+	public boolean equals(Object obj) {
+
+		if (this == obj) {
+			return true;
+		}
+
+		if (!(obj instanceof PageImpl<?>)) {
+			return false;
+		}
+
+		PageImpl<?> that = (PageImpl<?>) obj;
+
+		boolean totalEqual = this.total == that.total;
+		boolean contentEqual = this.content.equals(that.content);
+		boolean pageableEqual = this.pageable == null ? that.pageable == null : this.pageable.equals(that.pageable);
+
+		return totalEqual && contentEqual && pageableEqual;
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see java.lang.Object#hashCode()
+			 */
+	@Override
+	public int hashCode() {
+
+		int result = 17;
+
+		result = 31 * result + (int) (total ^ total >>> 32);
+		result = 31 * result + (pageable == null ? 0 : pageable.hashCode());
+		result = 31 * result + content.hashCode();
+
+		return result;
+	}
+}

src/main/java/org/springframework/data/domain/PageRequest.java

@@ -0,0 +1,164 @@
+/*
+ * Copyright 2008-2012 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.domain;
+
+import java.io.Serializable;
+
+import org.springframework.data.domain.Sort.Direction;
+
+/**
+ * Basic Java Bean implementation of {@code Pageable}.
+ * 
+ * @author Oliver Gierke
+ */
+public class PageRequest implements Pageable, Serializable {
+
+	private static final long serialVersionUID = 8280485938848398236L;
+
+	private final int page;
+	private final int size;
+	private final Sort sort;
+
+	/**
+	 * Creates a new {@link PageRequest}. Pages are zero indexed, thus providing 0 for {@code page} will return the first
+	 * page.
+	 * 
+	 * @param size
+	 * @param page
+	 */
+	public PageRequest(int page, int size) {
+
+		this(page, size, null);
+	}
+
+	/**
+	 * Creates a new {@link PageRequest} with sort parameters applied.
+	 * 
+	 * @param page
+	 * @param size
+	 * @param direction
+	 * @param properties
+	 */
+	public PageRequest(int page, int size, Direction direction, String... properties) {
+
+		this(page, size, new Sort(direction, properties));
+	}
+
+	/**
+	 * Creates a new {@link PageRequest} with sort parameters applied.
+	 * 
+	 * @param page
+	 * @param size
+	 * @param sort
+	 */
+	public PageRequest(int page, int size, Sort sort) {
+
+		if (0 > page) {
+			throw new IllegalArgumentException("Page index must not be less than zero!");
+		}
+
+		if (0 >= size) {
+			throw new IllegalArgumentException("Page size must not be less than or equal to zero!");
+		}
+
+		this.page = page;
+		this.size = size;
+		this.sort = sort;
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see org.springframework.data.domain.Pageable#getPageSize()
+			 */
+	public int getPageSize() {
+
+		return size;
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see org.springframework.data.domain.Pageable#getPageNumber()
+			 */
+	public int getPageNumber() {
+
+		return page;
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see org.springframework.data.domain.Pageable#getFirstItem()
+			 */
+	public int getOffset() {
+
+		return page * size;
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see org.springframework.data.domain.Pageable#getSort()
+			 */
+	public Sort getSort() {
+
+		return sort;
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see java.lang.Object#equals(java.lang.Object)
+			 */
+	@Override
+	public boolean equals(final Object obj) {
+
+		if (this == obj) {
+			return true;
+		}
+
+		if (!(obj instanceof PageRequest)) {
+			return false;
+		}
+
+		PageRequest that = (PageRequest) obj;
+
+		boolean pageEqual = this.page == that.page;
+		boolean sizeEqual = this.size == that.size;
+
+		boolean sortEqual = this.sort == null ? that.sort == null : this.sort.equals(that.sort);
+
+		return pageEqual && sizeEqual && sortEqual;
+	}
+
+	/*
+			 * (non-Javadoc)
+			 *
+			 * @see java.lang.Object#hashCode()
+			 */
+	@Override
+	public int hashCode() {
+
+		int result = 17;
+
+		result = 31 * result + page;
+		result = 31 * result + size;
+		result = 31 * result + (null == sort ? 0 : sort.hashCode());
+
+		return result;
+	}
+}

src/main/java/org/springframework/data/domain/Pageable.java

@@ -0,0 +1,52 @@
+/*
+ * Copyright 2008-2010 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.domain;
+
+/**
+ * Abstract interface for pagination information.
+ * 
+ * @author Oliver Gierke
+ */
+public interface Pageable {
+
+	/**
+	 * Returns the page to be returned.
+	 * 
+	 * @return the page to be returned.
+	 */
+	int getPageNumber();
+
+	/**
+	 * Returns the number of items to be returned.
+	 * 
+	 * @return the number of items of that page
+	 */
+	int getPageSize();
+
+	/**
+	 * Returns the offset to be taken according to the underlying page and page size.
+	 * 
+	 * @return the offset to be taken
+	 */
+	int getOffset();
+
+	/**
+	 * Returns the sorting parameters.
+	 * 
+	 * @return
+	 */
+	Sort getSort();
+}

src/main/java/org/springframework/data/domain/Persistable.java

@@ -0,0 +1,41 @@
+/*
+ * Copyright 2008-2011 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.domain;
+
+import java.io.Serializable;
+
+/**
+ * Simple interface for entities.
+ * 
+ * @param <ID> the type of the identifier
+ * @author Oliver Gierke
+ */
+public interface Persistable<ID extends Serializable> extends Serializable {
+
+	/**
+	 * Returns the id of the entity.
+	 * 
+	 * @return the id
+	 */
+	ID getId();
+
+	/**
+	 * Returns if the {@code Persistable} is new or was persisted already.
+	 * 
+	 * @return if the object is new
+	 */
+	boolean isNew();
+}

src/main/java/org/springframework/data/domain/Sort.java

@@ -0,0 +1,359 @@
+/*
+ * Copyright 2008-2013 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.domain;
+
+import java.io.Serializable;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Locale;
+
+import org.springframework.util.StringUtils;
+
+/**
+ * Sort option for queries. You have to provide at least a list of properties to sort for that must not include
+ * {@literal null} or empty strings. The direction defaults to {@link Sort#DEFAULT_DIRECTION}.
+ * 
+ * @author Oliver Gierke
+ */
+public class Sort implements Iterable<org.springframework.data.domain.Sort.Order>, Serializable {
+
+	private static final long serialVersionUID = 5737186511678863905L;
+	public static final Direction DEFAULT_DIRECTION = Direction.ASC;
+
+	private final List<Order> orders;
+
+	/**
+	 * Creates a new {@link Sort} instance using the given {@link Order}s.
+	 * 
+	 * @param orders must not be {@literal null}.
+	 */
+	public Sort(Order... orders) {
+		this(Arrays.asList(orders));
+	}
+
+	/**
+	 * Creates a new {@link Sort} instance.
+	 * 
+	 * @param orders must not be {@literal null} or contain {@literal null}.
+	 */
+	public Sort(List<Order> orders) {
+
+		if (null == orders || orders.isEmpty()) {
+			throw new IllegalArgumentException("You have to provide at least one sort property to sort by!");
+		}
+
+		this.orders = orders;
+	}
+
+	/**
+	 * Creates a new {@link Sort} instance. Order defaults to {@value Direction#ASC}.
+	 * 
+	 * @param properties must not be {@literal null} or contain {@literal null} or empty strings
+	 */
+	public Sort(String... properties) {
+		this(DEFAULT_DIRECTION, properties);
+	}
+
+	/**
+	 * Creates a new {@link Sort} instance.
+	 * 
+	 * @param direction defaults to {@linke Sort#DEFAULT_DIRECTION} (for {@literal null} cases, too)
+	 * @param properties must not be {@literal null} or contain {@literal null} or empty strings
+	 */
+	public Sort(Direction direction, String... properties) {
+		this(direction, properties == null ? new ArrayList<String>() : Arrays.asList(properties));
+	}
+
+	/**
+	 * Creates a new {@link Sort} instance.
+	 * 
+	 * @param direction
+	 * @param properties
+	 */
+	public Sort(Direction direction, List<String> properties) {
+
+		if (properties == null || properties.isEmpty()) {
+			throw new IllegalArgumentException("You have to provide at least one property to sort by!");
+		}
+
+		this.orders = new ArrayList<Order>(properties.size());
+
+		for (String property : properties) {
+			this.orders.add(new Order(direction, property));
+		}
+	}
+
+	/**
+	 * Returns a new {@link Sort} consisting of the {@link Order}s of the current {@link Sort} combined with the given
+	 * ones.
+	 * 
+	 * @param sort can be {@literal null}.
+	 * @return
+	 */
+	public Sort and(Sort sort) {
+
+		if (sort == null) {
+			return this;
+		}
+
+		ArrayList<Order> these = new ArrayList<Order>(this.orders);
+
+		for (Order order : sort) {
+			these.add(order);
+		}
+
+		return new Sort(these);
+	}
+
+	/**
+	 * Returns the order registered for the given property.
+	 * 
+	 * @param property
+	 * @return
+	 */
+	public Order getOrderFor(String property) {
+
+		for (Order order : this) {
+			if (order.getProperty().equals(property)) {
+				return order;
+			}
+		}
+
+		return null;
+	}
+
+	/*
+	 * (non-Javadoc)
+	 * @see java.lang.Iterable#iterator()
+	 */
+	public Iterator<Order> iterator() {
+		return this.orders.iterator();
+	}
+
+	/*
+	 * (non-Javadoc)
+	 * @see java.lang.Object#equals(java.lang.Object)
+	 */
+	@Override
+	public boolean equals(Object obj) {
+
+		if (this == obj) {
+			return true;
+		}
+
+		if (!(obj instanceof Sort)) {
+			return false;
+		}
+
+		Sort that = (Sort) obj;
+
+		return this.orders.equals(that.orders);
+	}
+
+	/*
+	 * (non-Javadoc)
+	 * @see java.lang.Object#hashCode()
+	 */
+	@Override
+	public int hashCode() {
+
+		int result = 17;
+		result = 31 * result + orders.hashCode();
+		return result;
+	}
+
+	/*
+	 * (non-Javadoc)
+	 * @see java.lang.Object#toString()
+	 */
+	@Override
+	public String toString() {
+		return StringUtils.collectionToCommaDelimitedString(orders);
+	}
+
+	/**
+	 * Enumeration for sort directions.
+	 * 
+	 * @author Oliver Gierke
+	 */
+	public static enum Direction {
+
+		ASC, DESC;
+
+		/**
+		 * Returns the {@link Direction} enum for the given {@link String} value.
+		 * 
+		 * @param value
+		 * @return
+		 */
+		public static Direction fromString(String value) {
+
+			try {
+				return Direction.valueOf(value.toUpperCase(Locale.US));
+			} catch (Exception e) {
+				throw new IllegalArgumentException(String.format(
+						"Invalid value '%s' for orders given! Has to be either 'desc' or 'asc' (case insensitive).", value), e);
+			}
+		}
+	}
+
+	/**
+	 * PropertyPath implements the pairing of an {@link Direction} and a property. It is used to provide input for
+	 * {@link Sort}
+	 * 
+	 * @author Oliver Gierke
+	 */
+	public static class Order implements Serializable {
+
+		private static final long serialVersionUID = 1522511010900108987L;
+
+		private final Direction direction;
+		private final String property;
+
+		/**
+		 * Creates a new {@link Order} instance. if order is {@literal null} then order defaults to
+		 * {@link Sort#DEFAULT_DIRECTION}
+		 * 
+		 * @param direction can be {@literal null}, will default to {@link Sort#DEFAULT_DIRECTION}
+		 * @param property must not be {@literal null} or empty.
+		 */
+		public Order(Direction direction, String property) {
+
+			if (!StringUtils.hasText(property)) {
+				throw new IllegalArgumentException("Property must not null or empty!");
+			}
+
+			this.direction = direction == null ? DEFAULT_DIRECTION : direction;
+			this.property = property;
+		}
+
+		/**
+		 * Creates a new {@link Order} instance. Takes a single property. Direction defaults to
+		 * {@link Sort#DEFAULT_DIRECTION}.
+		 * 
+		 * @param property must not be {@literal null} or empty.
+		 */
+		public Order(String property) {
+			this(DEFAULT_DIRECTION, property);
+		}
+
+		/**
+		 * @deprecated use {@link Sort#Sort(Direction, List)} instead.
+		 */
+		@Deprecated
+		public static List<Order> create(Direction direction, Iterable<String> properties) {
+
+			List<Order> orders = new ArrayList<Sort.Order>();
+			for (String property : properties) {
+				orders.add(new Order(direction, property));
+			}
+			return orders;
+		}
+
+		/**
+		 * Returns the order the property shall be sorted for.
+		 * 
+		 * @return
+		 */
+		public Direction getDirection() {
+			return direction;
+		}
+
+		/**
+		 * Returns the property to order for.
+		 * 
+		 * @return
+		 */
+		public String getProperty() {
+			return property;
+		}
+
+		/**
+		 * Returns whether sorting for this property shall be ascending.
+		 * 
+		 * @return
+		 */
+		public boolean isAscending() {
+			return this.direction.equals(Direction.ASC);
+		}
+
+		/**
+		 * Returns a new {@link Order} with the given {@link Order}.
+		 * 
+		 * @param order
+		 * @return
+		 */
+		public Order with(Direction order) {
+			return new Order(order, this.property);
+		}
+
+		/**
+		 * Returns a new {@link Sort} instance for the given properties.
+		 * 
+		 * @param properties
+		 * @return
+		 */
+		public Sort withProperties(String... properties) {
+			return new Sort(this.direction, properties);
+		}
+
+		/*
+		 * (non-Javadoc)
+		 * @see java.lang.Object#hashCode()
+		 */
+		@Override
+		public int hashCode() {
+
+			int result = 17;
+
+			result = 31 * result + direction.hashCode();
+			result = 31 * result + property.hashCode();
+
+			return result;
+		}
+
+		/*
+		 * (non-Javadoc)
+		 * @see java.lang.Object#equals(java.lang.Object)
+		 */
+		@Override
+		public boolean equals(Object obj) {
+
+			if (this == obj) {
+				return true;
+			}
+
+			if (!(obj instanceof Order)) {
+				return false;
+			}
+
+			Order that = (Order) obj;
+
+			return this.direction.equals(that.direction) && this.property.equals(that.property);
+		}
+
+		/*
+		 * (non-Javadoc)
+		 * @see java.lang.Object#toString()
+		 */
+		@Override
+		public String toString() {
+			return String.format("%s: %s", property, direction);
+		}
+	}
+}

src/main/java/org/springframework/data/domain/jaxb/OrderAdapter.java

@@ -0,0 +1,57 @@
+/*
+ * Copyright 2012 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.domain.jaxb;
+
+import javax.xml.bind.annotation.adapters.XmlAdapter;
+
+import org.springframework.data.domain.Sort.Order;
+import org.springframework.data.domain.jaxb.SpringDataJaxb.OrderDto;
+
+/**
+ * XmlAdapter to convert {@link Order} instances into {@link OrderDto}s and vice versa.
+ * 
+ * @author Oliver Gierke
+ */
+public class OrderAdapter extends XmlAdapter<OrderDto, Order> {
+
+	public static final OrderAdapter INSTANCE = new OrderAdapter();
+
+	/* 
+	 * (non-Javadoc)
+	 * @see javax.xml.bind.annotation.adapters.XmlAdapter#marshal(java.lang.Object)
+	 */
+	@Override
+	public OrderDto marshal(Order order) throws Exception {
+
+		if (order == null) {
+			return null;
+		}
+
+		OrderDto dto = new OrderDto();
+		dto.direction = order.getDirection();
+		dto.property = order.getProperty();
+		return dto;
+	}
+
+	/* 
+	 * (non-Javadoc)
+	 * @see javax.xml.bind.annotation.adapters.XmlAdapter#unmarshal(java.lang.Object)
+	 */
+	@Override
+	public Order unmarshal(OrderDto source) throws Exception {
+		return source == null ? null : new Order(source.direction, source.property);
+	}
+}

src/main/java/org/springframework/data/domain/jaxb/PageAdapter.java

@@ -0,0 +1,70 @@
+/*
+ * Copyright 2012 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.domain.jaxb;
+
+import java.util.Collections;
+import java.util.List;
+
+import javax.xml.bind.annotation.adapters.XmlAdapter;
+
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.jaxb.SpringDataJaxb.PageDto;
+import org.springframework.hateoas.Link;
+
+/**
+ * {@link XmlAdapter} to convert {@link Page} instances into {@link PageDto} instances and vice versa.
+ * 
+ * @author Oliver Gierke
+ */
+public class PageAdapter extends XmlAdapter<PageDto, Page<Object>> {
+
+	/*
+	 * (non-Javadoc)
+	 * @see javax.xml.bind.annotation.adapters.XmlAdapter#marshal(java.lang.Object)
+	 */
+	@Override
+	public PageDto marshal(Page<Object> source) throws Exception {
+
+		if (source == null) {
+			return null;
+		}
+
+		PageDto dto = new PageDto();
+		dto.content = source.getContent();
+		dto.add(getLinks(source));
+
+		return dto;
+	}
+
+	/* 
+	 * (non-Javadoc)
+	 * @see javax.xml.bind.annotation.adapters.XmlAdapter#unmarshal(java.lang.Object)
+	 */
+	@Override
+	public Page<Object> unmarshal(PageDto v) throws Exception {
+		return null;
+	}
+
+	/**
+	 * Return additional links that shall be added to the {@link PageDto}.
+	 * 
+	 * @param source the source {@link Page}.
+	 * @return
+	 */
+	protected List<Link> getLinks(Page<?> source) {
+		return Collections.emptyList();
+	}
+}

src/main/java/org/springframework/data/domain/jaxb/PageableAdapter.java

@@ -0,0 +1,70 @@
+/*
+ * Copyright 2012 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.domain.jaxb;
+
+import java.util.Collections;
+
+import javax.xml.bind.annotation.adapters.XmlAdapter;
+
+import org.springframework.data.domain.PageRequest;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.domain.Sort;
+import org.springframework.data.domain.jaxb.SpringDataJaxb.OrderDto;
+import org.springframework.data.domain.jaxb.SpringDataJaxb.PageRequestDto;
+import org.springframework.data.domain.jaxb.SpringDataJaxb.SortDto;
+
+/**
+ * {@link XmlAdapter} to convert {@link Pageable} instances int a {@link PageRequestDto} and vice versa.
+ * 
+ * @author Oliver Gierke
+ */
+class PageableAdapter extends XmlAdapter<PageRequestDto, Pageable> {
+
+	/*
+	 * (non-Javadoc)
+	 * @see javax.xml.bind.annotation.adapters.XmlAdapter#marshal(java.lang.Object)
+	 */
+	@Override
+	public PageRequestDto marshal(Pageable request) throws Exception {
+
+		SortDto sortDto = SortAdapter.INSTANCE.marshal(request.getSort());
+
+		PageRequestDto dto = new PageRequestDto();
+		dto.orders = sortDto == null ? Collections.<OrderDto> emptyList() : sortDto.orders;
+		dto.page = request.getPageNumber();
+		dto.size = request.getPageSize();
+
+		return dto;
+	}
+
+	/*
+	 * (non-Javadoc)
+	 * @see javax.xml.bind.annotation.adapters.XmlAdapter#unmarshal(java.lang.Object)
+	 */
+	@Override
+	public Pageable unmarshal(PageRequestDto v) throws Exception {
+
+		if (v.orders.isEmpty()) {
+			return new PageRequest(v.page, v.size);
+		}
+
+		SortDto sortDto = new SortDto();
+		sortDto.orders = v.orders;
+		Sort sort = SortAdapter.INSTANCE.unmarshal(sortDto);
+
+		return new PageRequest(v.page, v.size, sort);
+	}
+}

src/main/java/org/springframework/data/domain/jaxb/SortAdapter.java

@@ -0,0 +1,42 @@
+package org.springframework.data.domain.jaxb;
+
+import javax.xml.bind.annotation.adapters.XmlAdapter;
+
+import org.springframework.data.domain.Sort;
+import org.springframework.data.domain.jaxb.SpringDataJaxb.SortDto;
+
+/**
+ * {@link XmlAdapter} to convert {@link Sort} instances into {@link SortDto} instances and vice versa.
+ * 
+ * @author Oliver Gierke
+ */
+public class SortAdapter extends XmlAdapter<SortDto, Sort> {
+
+	public static final SortAdapter INSTANCE = new SortAdapter();
+
+	/*
+	 * (non-Javadoc)
+	 * @see javax.xml.bind.annotation.adapters.XmlAdapter#marshal(java.lang.Object)
+	 */
+	@Override
+	public SortDto marshal(Sort source) throws Exception {
+
+		if (source == null) {
+			return null;
+		}
+
+		SortDto dto = new SortDto();
+		dto.orders = SpringDataJaxb.marshal(source, OrderAdapter.INSTANCE);
+
+		return dto;
+	}
+
+	/*
+	 * (non-Javadoc)
+	 * @see javax.xml.bind.annotation.adapters.XmlAdapter#unmarshal(java.lang.Object)
+	 */
+	@Override
+	public Sort unmarshal(SortDto source) throws Exception {
+		return source == null ? null : new Sort(SpringDataJaxb.unmarshal(source.orders, OrderAdapter.INSTANCE));
+	}
+}

src/main/java/org/springframework/data/domain/jaxb/SpringDataJaxb.java

@@ -0,0 +1,153 @@
+/*
+ * Copyright 2012 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.domain.jaxb;
+
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+
+import javax.xml.bind.annotation.XmlAccessType;
+import javax.xml.bind.annotation.XmlAccessorType;
+import javax.xml.bind.annotation.XmlAnyElement;
+import javax.xml.bind.annotation.XmlAttribute;
+import javax.xml.bind.annotation.XmlElement;
+import javax.xml.bind.annotation.XmlElementWrapper;
+import javax.xml.bind.annotation.XmlRootElement;
+import javax.xml.bind.annotation.adapters.XmlAdapter;
+
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.PageRequest;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.domain.Sort;
+import org.springframework.data.domain.Sort.Direction;
+import org.springframework.data.domain.Sort.Order;
+import org.springframework.hateoas.ResourceSupport;
+import org.springframework.util.Assert;
+
+/**
+ * Helper class containing utility methods to implement JAXB {@link XmlAdapter}s as well as the DTO types to be
+ * marshalled by JAXB.
+ * 
+ * @author Oliver Gierke
+ */
+public class SpringDataJaxb {
+
+	public static final String NAMESPACE = "http://www.springframework.org/schema/data/jaxb";
+
+	/**
+	 * The DTO for {@link Pageable}s/{@link PageRequest}s.
+	 * 
+	 * @author Oliver Gierke
+	 */
+	@XmlRootElement(name = "page-request", namespace = NAMESPACE)
+	@XmlAccessorType(XmlAccessType.FIELD)
+	public static class PageRequestDto {
+
+		@XmlAttribute
+		int page, size;
+		@XmlElement(name = "order", namespace = NAMESPACE)
+		List<OrderDto> orders = new ArrayList<OrderDto>();
+	}
+
+	/**
+	 * The DTO for {@link Sort}.
+	 * 
+	 * @author Oliver Gierke
+	 */
+	@XmlRootElement(name = "sort", namespace = NAMESPACE)
+	@XmlAccessorType(XmlAccessType.FIELD)
+	public static class SortDto {
+
+		@XmlElement(name = "order", namespace = SpringDataJaxb.NAMESPACE)
+		List<OrderDto> orders = new ArrayList<OrderDto>();
+	}
+
+	/**
+	 * The DTO for {@link Order}.
+	 * 
+	 * @author Oliver Gierke
+	 */
+	@XmlRootElement(name = "order", namespace = NAMESPACE)
+	@XmlAccessorType(XmlAccessType.FIELD)
+	public static class OrderDto {
+
+		@XmlAttribute
+		String property;
+		@XmlAttribute
+		Direction direction;
+	}
+
+	/**
+	 * The DTO for {@link Page}.
+	 * 
+	 * @author Oliver Gierke
+	 */
+	@XmlRootElement(name = "page", namespace = NAMESPACE)
+	@XmlAccessorType(XmlAccessType.FIELD)
+	public static class PageDto extends ResourceSupport {
+
+		@XmlAnyElement
+		@XmlElementWrapper(name = "content")
+		List<Object> content;
+	}
+
+	/**
+	 * Unmarshals each element of the given {@link Collection} using the given {@link XmlAdapter}.
+	 * 
+	 * @param source
+	 * @param adapter must not be {@literal null}.
+	 * @return
+	 * @throws Exception
+	 */
+	public static <T, S> List<T> unmarshal(Collection<S> source, XmlAdapter<S, T> adapter) throws Exception {
+
+		Assert.notNull(adapter);
+
+		if (source == null || source.isEmpty()) {
+			return Collections.emptyList();
+		}
+
+		List<T> result = new ArrayList<T>(source.size());
+		for (S element : source) {
+			result.add(adapter.unmarshal(element));
+		}
+		return result;
+	}
+
+	/**
+	 * Marshals each of the elements of the given {@link Iterable} using the given {@link XmlAdapter}.
+	 * 
+	 * @param source
+	 * @param adapter must not be {@literal null}.
+	 * @return
+	 * @throws Exception
+	 */
+	public static <T, S> List<S> marshal(Iterable<T> source, XmlAdapter<S, T> adapter) throws Exception {
+
+		Assert.notNull(adapter);
+
+		if (source == null) {
+			return Collections.emptyList();
+		}
+
+		List<S> result = new ArrayList<S>();
+		for (T element : source) {
+			result.add(adapter.marshal(element));
+		}
+		return result;
+	}
+}

src/main/java/org/springframework/data/domain/jaxb/package-info.java

@@ -0,0 +1,21 @@
+/**
+ * Central domain abstractions especially to be used in combination with the {@link org.springframework.data.repository.Repository} abstraction.
+ *
+ * @see org.springframework.data.repository.Repository
+ */
+@XmlSchema(xmlns = { @XmlNs(prefix = "sd", namespaceURI = org.springframework.data.domain.jaxb.SpringDataJaxb.NAMESPACE) })
+@XmlJavaTypeAdapters({
+		@XmlJavaTypeAdapter(value = org.springframework.data.domain.jaxb.PageableAdapter.class, type = Pageable.class),
+		@XmlJavaTypeAdapter(value = org.springframework.data.domain.jaxb.SortAdapter.class, type = Sort.class),
+		@XmlJavaTypeAdapter(value = org.springframework.data.domain.jaxb.PageAdapter.class, type = Page.class) })
+package org.springframework.data.domain.jaxb;
+
+import javax.xml.bind.annotation.XmlNs;
+import javax.xml.bind.annotation.XmlSchema;
+import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter;
+import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapters;
+
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.domain.Sort;
+

src/main/java/org/springframework/data/domain/package-info.java

@@ -0,0 +1,7 @@
+/**
+ * Central domain abstractions especially to be used in combination with the {@link org.springframework.data.repository.Repository} abstraction.
+ *
+ * @see org.springframework.data.repository.Repository
+ */
+package org.springframework.data.domain;
+