All Downloads are FREE. Search and download functionalities are using the official Maven repository.

net.kaczmarzyk.spring.data.jpa.web.SpecificationFactory Maven / Gradle / Ivy

Go to download

An alternative API for filtering data with Spring MVC and Spring Data JPA. This library provides a custom HandlerMethodArgumentResolver that transforms HTTP parameters into a Specification object ready to use with Spring Data repositories.

There is a newer version: 3.1.0
Show newest version
/**
 * Copyright 2014-2022 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 net.kaczmarzyk.spring.data.jpa.web;

import net.kaczmarzyk.spring.data.jpa.utils.TypeUtil;
import org.springframework.context.support.AbstractApplicationContext;
import org.springframework.core.convert.ConversionService;
import org.springframework.data.jpa.domain.Specification;

import java.lang.annotation.Annotation;
import java.util.*;
import java.util.function.Consumer;

import static java.util.Objects.nonNull;
import static java.util.function.Function.identity;
import static java.util.stream.Collectors.toMap;

/**
 * @author Tomasz Kaczmarzyk
 * @author Jakub Radlica
 */
public class SpecificationFactory {

	private Map, SpecificationResolver> resolversBySupportedType;

	public SpecificationFactory(ConversionService conversionService, AbstractApplicationContext abstractApplicationContext) {
		SimpleSpecificationResolver simpleSpecificationResolver = new SimpleSpecificationResolver(conversionService, abstractApplicationContext);

		resolversBySupportedType = Arrays.asList(
						simpleSpecificationResolver,
						new OrSpecificationResolver(simpleSpecificationResolver),
						new DisjunctionSpecificationResolver(simpleSpecificationResolver),
						new ConjunctionSpecificationResolver(simpleSpecificationResolver),
						new AndSpecificationResolver(simpleSpecificationResolver),
						new JoinSpecificationResolver(),
						new JoinsSpecificationResolver(),
						new JoinFetchSpecificationResolver(),
						new RepeatedJoinFetchResolver(),
						new RepeatedJoinResolver()).stream()
				.collect(toMap(
						SpecificationResolver::getSupportedSpecificationDefinition,
						identity(),
						(u,v) -> { throw new IllegalStateException(String.format("Duplicate key %s", u)); },
						LinkedHashMap::new
				));

	}

	public Specification createSpecificationDependingOn(ProcessingContext context) {
		List> specs = resolveSpec(context);

		if (specs.isEmpty()) {
			return null;
		}

		if (specs.size() == 1) {
			Specification firstSpecification = specs.iterator().next();

			if (Specification.class == context.getParameterType()) {
				return firstSpecification;
			} else {
				return (Specification) EnhancerUtil.wrapWithIfaceImplementation(context.getParameterType(), firstSpecification);
			}
		}

		Specification spec = new net.kaczmarzyk.spring.data.jpa.domain.Conjunction<>(specs);

		return (Specification) EnhancerUtil.wrapWithIfaceImplementation(context.getParameterType(), spec);
	}

	private List> resolveSpec(ProcessingContext context) {
		List> specAccumulator = new ArrayList<>();

		resolveSpecFromInterfaceAnnotations(context, specAccumulator);
		resolveSpecFromParameterAnnotations(context, specAccumulator);

		return specAccumulator;
	}

	private void resolveSpecFromParameterAnnotations(ProcessingContext context,
													 List> accum) {
		forEachSupportedSpecificationDefinition(
				context.getParameterAnnotations(),
				specDefinition -> {
					Specification specification = buildSpecification(context, specDefinition);
					if (nonNull(specification)) {
						accum.add(specification);
					}
				}
		);
	}

	private void resolveSpecFromInterfaceAnnotations(ProcessingContext context,
													 List> accumulator) {
		Collection> ifaceTree = TypeUtil.interfaceTree(context.getParameterType());

		for (Class iface : ifaceTree) {
			forEachSupportedInterfaceSpecificationDefinition(iface,
					(specDefinition) -> {
						Specification specification = buildSpecification(context, specDefinition);
						if (nonNull(specification)) {
							accumulator.add(specification);
						}
					}
			);
		}
	}

	private Specification buildSpecification(ProcessingContext context, Annotation specDef) {
		SpecificationResolver resolver = resolversBySupportedType.get(specDef.annotationType());

		if (resolver == null) {
			throw new IllegalArgumentException(
					"Definition is not supported. " +
							"Specification resolver is not able to build specification from definition of type :" + specDef.annotationType()
			);
		}

		return resolver.buildSpecification(context, specDef);
	}

	private void forEachSupportedSpecificationDefinition(Annotation[] parameterAnnotations, Consumer specificationBuilder) {
		for (Annotation annotation : parameterAnnotations) {
			for (Class annotationType : resolversBySupportedType.keySet()) {
				if (annotationType.isAssignableFrom(annotation.getClass())) {
					specificationBuilder.accept(annotation);
				}
			}
		}
	}

	private void forEachSupportedInterfaceSpecificationDefinition(Class target, Consumer specificationBuilder) {
		for (Class annotationType : resolversBySupportedType.keySet()) {
			if (target.getAnnotations().length != 0) {
				Annotation potentialAnnotation = target.getAnnotation(annotationType);
				if (potentialAnnotation != null) {
					specificationBuilder.accept(potentialAnnotation);
				}
			}
		}
	}

	public Set> getResolversBySupportedType() {
		return resolversBySupportedType.keySet();
	}
}