Java tutorial
/* * openwms.org, the Open Warehouse Management System. * Copyright (C) 2014 Heiko Scherrer * * This file is part of openwms.org. * * openwms.org is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as * published by the Free Software Foundation; either version 2 of the * License, or (at your option) any later version. * * openwms.org is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this software. If not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA * 02110-1301 USA, or see the FSF site: http://www.fsf.org. */ package org.openwms.tms.service; import java.util.ArrayList; import java.util.Collection; import java.util.List; import java.util.Optional; import java.util.stream.Collectors; import java.util.stream.Stream; import org.ameba.exception.NotFoundException; import org.ameba.i18n.Translator; import org.openwms.common.Target; import org.openwms.tms.Message; import org.openwms.tms.PriorityLevel; import org.openwms.tms.StateChangeException; import org.openwms.tms.TMSMessageCodes; import org.openwms.tms.TargetResolver; import org.openwms.tms.TransportOrder; import org.openwms.tms.TransportOrderRepository; import org.openwms.tms.TransportOrderState; import org.openwms.tms.TransportServiceEvent; import org.openwms.tms.TransportationService; import org.openwms.tms.UpdateFunction; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.context.ApplicationContext; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; /** * A TransportationServiceImpl is a Spring managed transactional service. * * @author <a href="mailto:scherrer@openwms.org">Heiko Scherrer</a> * @see TransportationService * @since 1.0 */ @Transactional @Service class TransportationServiceImpl implements TransportationService<TransportOrder> { private static final Logger LOGGER = LoggerFactory.getLogger(TransportationServiceImpl.class); @Autowired private ApplicationContext ctx; @Autowired private TransportOrderRepository repository; @Autowired(required = false) private List<TargetResolver<Target>> targetResolvers; @Autowired(required = false) private List<UpdateFunction> updateFunctions; @Autowired private Translator translator; @Override public List<TransportOrder> findBy(String barcode, String... states) { return repository.findByTransportUnitBKAndStates(barcode, Stream.of(states).map(TransportOrderState::valueOf).collect(Collectors.toList()) .toArray(new TransportOrderState[states.length])); } /** * {@inheritDoc} */ @Override public int getNoTransportOrdersToTarget(String target, String... states) { int i = 0; for (TargetResolver<Target> tr : targetResolvers) { Optional<Target> t = tr.resolve(target); if (t.isPresent()) { i = +tr.getHandler().getNoTOToTarget(t.get()); } } return i; } /** * {@inheritDoc} * <p> * Checks that all necessary data to create a TransportOrder is given, does not do any logical checks, whether a target is blocked or a * {@link TransportOrder} for the {@code TransportUnit} exist. * * @throws NotFoundException when the barcode is {@literal null} or no transportUnit with barcode can be found or no target * can be found. */ @Override public TransportOrder create(String barcode, String target, PriorityLevel priority) { if (barcode == null) { throw new NotFoundException("Barcode cannot be null when creating a TransportOrder"); } LOGGER.debug("Trying to create TransportOrder with Barcode [{}], to Target [{}], with Priority [{}]", barcode, target, priority); TransportOrder transportOrder = new TransportOrder(barcode).setTargetLocation(target) .setTargetLocationGroup(target); if (priority != null) { transportOrder.setPriority(priority); } transportOrder = repository.save(transportOrder); LOGGER.debug("TransportOrder for Barcode [{}] created. PKey is [{}], PK is [{}]", barcode, transportOrder.getPersistentKey(), transportOrder.getPk()); ctx.publishEvent( new TransportServiceEvent(transportOrder.getPk(), TransportServiceEvent.TYPE.TRANSPORT_CREATED)); LOGGER.debug("TransportOrder for Barcode [{}] persisted. PKey is [{}], PK is [{}]", barcode, transportOrder.getPersistentKey(), transportOrder.getPk()); return transportOrder; } /** * {@inheritDoc} */ @Override public TransportOrder update(TransportOrder transportOrder) { TransportOrder saved = findBy(transportOrder.getPersistentKey()); updateFunctions.forEach(up -> up.update(saved, transportOrder)); return repository.save(saved); } /** * {@inheritDoc} */ @Override public Collection<String> change(Collection<String> pKeys, TransportOrderState state) { List<String> failure = new ArrayList<>(pKeys.size()); List<TransportOrder> transportOrders = repository.findByPKey(new ArrayList<>(pKeys)); for (TransportOrder transportOrder : transportOrders) { try { LOGGER.debug("Trying to turn TransportOrder [{}] into state [{}]", transportOrder.getPk(), state); transportOrder.changeState(state); ctx.publishEvent(new TransportServiceEvent(transportOrder.getPk(), TransportOrderUtil.convertToEventType(state))); } catch (StateChangeException sce) { LOGGER.error("Could not turn TransportOrder: [{}] into [{}], because of [{}]", transportOrder.getPk(), state, sce.getMessage()); Message problem = new Message.Builder().withMessage(sce.getMessage()).build(); transportOrder.setProblem(problem); failure.add(transportOrder.getPk().toString()); } } return failure; } /** * {@inheritDoc} */ @Override public TransportOrder findByPKey(String pKey) { return findBy(pKey); } private TransportOrder findBy(String pKey) { return repository.findByPKey(pKey).orElseThrow(() -> new NotFoundException(translator, TMSMessageCodes.TO_WITH_PKEY_NOT_FOUND, new String[] { pKey }, pKey)); } }