/// <summary>
/// Books new cargo for specified origin, destination and arrival deadline.
/// </summary>
/// <param name="origin">Origin of a cargo in UnLocode format.</param>
/// <param name="destination">Destination of a cargo in UnLocode format.</param>
/// <param name="arrivalDeadline">Arrival deadline.</param>
/// <returns>Cargo tracking id.</returns>
public string BookNewCargo(string origin, string destination, DateTime arrivalDeadline)
{
var command = new BookNewCargoCommand
{
Origin = origin,
Destination = destination,
ArrivalDeadline = arrivalDeadline
};
var result = (BookNewCargoCommandResult)_pipelineFactory.Process(command);
return(result.TrackingId);
}
public ActionResult NewCargo(BookNewCargoCommand command)
{
if (command.ArrivalDeadline == DateTime.MinValue)
{
ModelState.AddModelError("ArrivalDeadline", "Arrival deadline is required and must be a valid date.");
}
if (command.Origin == command.Destination)
{
ModelState.AddModelError("Destination", "Destination of a cargo must be different from its origin.");
}
if (!ModelState.IsValid)
{
AddShipingLocations();
return(View());
}
_bus.Send(command);
return(RedirectToAction("ListCargos"));
}
public void CanTransportFromHongkongToStockholm()
{
/* Test setup: A cargo should be shipped from Hongkong to Stockholm,
* and it should arrive in no more than two weeks. */
var origin = Hongkong;
var destination = Stockholm;
var arrivalDeadline = DateTime.Now.AddDays(60);
/* Use case 1: booking
*
* A new cargo is booked, and the unique tracking id is assigned to the cargo. */
var bookNewCargoCommand = new BookNewCargoCommand
{
Origin = origin.UnLocode.CodeString,
Destination = destination.UnLocode.CodeString,
ArrivalDeadline = arrivalDeadline
};
var bookNewCargoCommandResult = (BookNewCargoCommandResult)CommandPipeline.Process(bookNewCargoCommand);
TrackingId trackingId = new TrackingId(bookNewCargoCommandResult.TrackingId);
/* The tracking id can be used to lookup the cargo in the repository.
*
* Important: The cargo, and thus the domain model, is responsible for determining
* the status of the cargo, whether it is on the right track or not and so on.
* This is core domain logic.
*
* Tracking the cargo basically amounts to presenting information extracted from
* the cargo aggregate in a suitable way. */
var cargo = CargoRepository.Find(trackingId);
Assert.IsNotNull(cargo);
Assert.AreEqual(TransportStatus.NotReceived, cargo.Delivery.TransportStatus);
Assert.AreEqual(RoutingStatus.NotRouted, cargo.Delivery.RoutingStatus);
Assert.IsFalse(cargo.Delivery.IsMisdirected);
Assert.IsNull(cargo.Delivery.EstimatedTimeOfArrival);
//Assert.IsNull(cargo.Delivery.NextExpectedActivity);
/* Use case 2: routing
*
* A number of possible routes for this cargo is requested and may be
* presented to the customer in some way for him/her to choose from.
* Selection could be affected by things like price and time of delivery,
* but this test simply uses an arbitrary selection to mimic that process.
*
* The cargo is then assigned to the selected route, described by an itinerary. */
var routeCandidates = RequestPossibleRoutesForCargo(trackingId);
var selectedRoute = SelectPreferedItinerary(routeCandidates);
AssignCargoToRoute(trackingId, selectedRoute);
Assert.AreEqual(TransportStatus.NotReceived, cargo.Delivery.TransportStatus);
Assert.AreEqual(RoutingStatus.Routed, cargo.Delivery.RoutingStatus);
Assert.IsNotNull(cargo.Delivery.EstimatedTimeOfArrival);
Assert.AreEqual(new HandlingActivity(HandlingEventType.Receive, Hongkong), cargo.Delivery.NextExpectedActivity);
/*
* Use case 3: handling
*
* A handling event registration attempt will be formed from parsing
* the data coming in as a handling report either via
* the web service interface or as an uploaded CSV file.
*
* The handling event factory tries to create a HandlingEvent from the attempt,
* and if the factory decides that this is a plausible handling event, it is stored.
* If the attempt is invalid, for example if no cargo exists for the specfied tracking id,
* the attempt is rejected.
*
* Handling begins: cargo is received in Hongkong.
*/
RegisterHandlingEvent(
new DateTime(2009, 3, 1), trackingId, Hongkong.UnLocode, HandlingEventType.Receive
);
Assert.AreEqual(TransportStatus.InPort, cargo.Delivery.TransportStatus);
Assert.AreEqual(Hongkong, cargo.Delivery.LastKnownLocation);
// Next event: Load onto voyage CM003 in Hongkong
RegisterHandlingEvent(
new DateTime(2009, 3, 3), trackingId, Hongkong.UnLocode, HandlingEventType.Load
);
// Check current state - should be ok
//Assert.AreEqual(v100, cargo.Delivery.currentVoyage());
Assert.AreEqual(Hongkong, cargo.Delivery.LastKnownLocation);
Assert.AreEqual(TransportStatus.OnboardCarrier, cargo.Delivery.TransportStatus);
Assert.IsFalse(cargo.Delivery.IsMisdirected);
//Assert.AreEqual(new HandlingActivity(UNLOAD, NEWYORK, v100), cargo.Delivery.nextExpectedActivity());
/*
* Here's an attempt to register a handling event that's not valid
* because there is no voyage with the specified voyage number,
* and there's no location with the specified UN Locode either.
*
* This attempt will be rejected and will not affect the cargo delivery in any way.
*/
//VoyageNumber noSuchVoyageNumber = new VoyageNumber("XX000");
//UnLocode noSuchUnLocode = new UnLocode("ZZZZZ");
//try
//{
// HandlingEventService.RegisterHandlingEvent(
// new DateTime(2009, 3, 5), trackingId, noSuchUnLocode, HandlingEventType.Load
// );
// Assert.Fail("Should not be able to register a handling event with invalid location and voyage");
//}
//catch (ArgumentException)
//{
//}
// Cargo is now (incorrectly) unloaded in Tokyo
RegisterHandlingEvent(
new DateTime(2009, 3, 5), trackingId, Tokyo.UnLocode, HandlingEventType.Unload
);
// Check current state - cargo is misdirected!
//Assert.AreEqual(NONE, cargo.Delivery.currentVoyage());
Assert.AreEqual(Tokyo, cargo.Delivery.LastKnownLocation);
Assert.AreEqual(TransportStatus.InPort, cargo.Delivery.TransportStatus);
Assert.IsTrue(cargo.Delivery.IsMisdirected);
//Assert.IsNull(cargo.Delivery.nextExpectedActivity());
// -- Cargo needs to be rerouted --
// TODO cleaner reroute from "earliest location from where the new route originates"
// Specify a new route, this time from Tokyo (where it was incorrectly unloaded) to Stockholm
var fromTokyo = new RouteSpecification(Tokyo, Stockholm, arrivalDeadline);
cargo.SpecifyNewRoute(fromTokyo);
// The old itinerary does not satisfy the new specification
Assert.AreEqual(RoutingStatus.Misrouted, cargo.Delivery.RoutingStatus);
//Assert.IsNull(cargo.Delivery.nextExpectedActivity());
// Repeat procedure of selecting one out of a number of possible routes satisfying the route spec
var newRoutes = RequestPossibleRoutesForCargo(trackingId);
var newSelectedRoute = SelectPreferedItinerary(newRoutes);
AssignCargoToRoute(trackingId, newSelectedRoute);
// New itinerary should satisfy new route
Assert.AreEqual(RoutingStatus.Routed, cargo.Delivery.RoutingStatus);
// TODO we can't handle the face that after a reroute, the cargo isn't misdirected anymore
//Assert.IsFalse(cargo.isMisdirected());
//Assert.AreEqual(new HandlingActivity(LOAD, TOKYO), cargo.nextExpectedActivity());
// -- Cargo has been rerouted, shipping continues --
// Load in Tokyo
RegisterHandlingEvent(new DateTime(2009, 3, 8), trackingId, Tokyo.UnLocode, HandlingEventType.Load);
// Check current state - should be ok
//Assert.AreEqual(v300, cargo.Delivery.currentVoyage());
Assert.AreEqual(Tokyo, cargo.Delivery.LastKnownLocation);
Assert.AreEqual(TransportStatus.OnboardCarrier, cargo.Delivery.TransportStatus);
Assert.IsFalse(cargo.Delivery.IsMisdirected);
//Assert.AreEqual(new HandlingActivity(UNLOAD, HAMBURG, v300), cargo.Delivery.nextExpectedActivity());
// Unload in Hamburg
RegisterHandlingEvent(new DateTime(2009, 3, 12), trackingId, Hamburg.UnLocode, HandlingEventType.Unload);
// Check current state - should be ok
//Assert.AreEqual(NONE, cargo.Delivery.currentVoyage());
Assert.AreEqual(Hamburg, cargo.Delivery.LastKnownLocation);
Assert.AreEqual(TransportStatus.InPort, cargo.Delivery.TransportStatus);
Assert.IsFalse(cargo.Delivery.IsMisdirected);
//Assert.AreEqual(new HandlingActivity(LOAD, HAMBURG, v400), cargo.Delivery.nextExpectedActivity());
// Load in Hamburg
RegisterHandlingEvent(new DateTime(2009, 3, 14), trackingId, Hamburg.UnLocode, HandlingEventType.Load);
// Check current state - should be ok
//Assert.AreEqual(v400, cargo.Delivery.currentVoyage());
Assert.AreEqual(Hamburg, cargo.Delivery.LastKnownLocation);
Assert.AreEqual(TransportStatus.OnboardCarrier, cargo.Delivery.TransportStatus);
Assert.IsFalse(cargo.Delivery.IsMisdirected);
//Assert.AreEqual(new HandlingActivity(UNLOAD, STOCKHOLM, v400), cargo.Delivery.nextExpectedActivity());
// Unload in Stockholm
RegisterHandlingEvent(new DateTime(2009, 3, 15), trackingId, Stockholm.UnLocode, HandlingEventType.Unload);
// Check current state - should be ok
//Assert.AreEqual(NONE, cargo.Delivery.currentVoyage());
Assert.AreEqual(Stockholm, cargo.Delivery.LastKnownLocation);
Assert.AreEqual(TransportStatus.InPort, cargo.Delivery.TransportStatus);
Assert.IsFalse(cargo.Delivery.IsMisdirected);
//Assert.AreEqual(new HandlingActivity(CLAIM, STOCKHOLM), cargo.Delivery.nextExpectedActivity());
// Finally, cargo is claimed in Stockholm. This ends the cargo lifecycle from our perspective.
RegisterHandlingEvent(new DateTime(2009, 3, 16), trackingId, Stockholm.UnLocode, HandlingEventType.Claim);
// Check current state - should be ok
//Assert.AreEqual(NONE, cargo.Delivery.currentVoyage());
Assert.AreEqual(Stockholm, cargo.Delivery.LastKnownLocation);
Assert.AreEqual(TransportStatus.Claimed, cargo.Delivery.TransportStatus);
Assert.IsFalse(cargo.Delivery.IsMisdirected);
//Assert.IsNull(cargo.Delivery.nextExpectedActivity());
}
