org.broadleafcommerce.common.copy

Interface MultiTenantCloneable<T>

All Known Subinterfaces:

Address, BandedPriceFulfillmentOption, BandedWeightFulfillmentOption, CandidateItemOffer, Category, CategoryAttribute, CategoryExcludedSearchFacet, CategoryProductXref, CategorySearchFacet, CategoryXref, Customer, CustomerAddress, CustomerAttribute, CustomerPayment, CustomerPhone, DataDrivenEnumeration, DataDrivenEnumerationValue, FeaturedProduct, Field, FieldDefinition, FieldGroup, FixedPriceFulfillmentOption, FulfillmentOption, ImageStaticAsset, Offer, OfferCode, OfferInfo, OfferItemCriteria, OfferOfferRuleXref, OfferQualifyingCriteriaXref, OfferRule, Order, OrderAttribute, OrderItemAttribute, OrderItemPriceDetail, OrderItemPriceDetailAdjustment, Page, PageAttribute, PageField, PageItemCriteria, PageRule, PageTemplate, PageTemplateFieldGroupXref, Product, ProductAttribute, ProductBundle, ProductOption, ProductOptionValue, ProductOptionXref, RequiredFacet, SearchFacet, SearchFacetRange, Sku, SkuAttribute, SkuBundleItem, SkuProductOptionValueXref, StaticAsset, StaticAssetDescription, StructuredContent, StructuredContentField, StructuredContentFieldTemplate, StructuredContentFieldXref, StructuredContentItemCriteria, StructuredContentRule, StructuredContentType, SystemProperty, Translation, URLHandler

All Known Implementing Classes:

AddressImpl, BandedPriceFulfillmentOptionImpl, BandedWeightFulfillmentOptionImpl, BundleOrderItemImpl, CandidateItemOfferImpl, CategoryAttributeImpl, CategoryExcludedSearchFacetImpl, CategoryImpl, CategoryMediaXrefImpl, CategoryProductXrefImpl, CategorySearchFacetImpl, CategoryXrefImpl, CrossSaleProductImpl, CustomerAddressImpl, CustomerAttributeImpl, CustomerImpl, CustomerPaymentImpl, CustomerPhoneImpl, DataDrivenEnumerationImpl, DataDrivenEnumerationValueImpl, DiscreteOrderItemImpl, DynamicPriceDiscreteOrderItemImpl, FeaturedProductImpl, FieldDefinitionImpl, FieldGroupImpl, FieldImpl, FixedPriceFulfillmentOptionImpl, FulfillmentOptionImpl, GiftWrapOrderItemImpl, ImageStaticAssetImpl, MediaImpl, NullOrderImpl, NullURLHandler, OfferCodeImpl, OfferImpl, OfferInfoImpl, OfferItemCriteriaImpl, OfferOfferRuleXrefImpl, OfferQualifyingCriteriaXrefImpl, OfferRuleImpl, OrderAttributeImpl, OrderImpl, OrderItemAttributeImpl, OrderItemImpl, OrderItemPriceDetailAdjustmentImpl, OrderItemPriceDetailImpl, PageAttributeImpl, PageFieldImpl, PageImpl, PageItemCriteriaImpl, PageRuleImpl, PageTemplateFieldGroupXrefImpl, PageTemplateImpl, ProductAttributeImpl, ProductBundleImpl, ProductImpl, ProductOptionImpl, ProductOptionValueImpl, ProductOptionXrefImpl, RequiredFacetImpl, SearchFacetImpl, SearchFacetRangeImpl, SkuAttributeImpl, SkuBundleItemImpl, SkuImpl, SkuMediaXrefImpl, SkuProductOptionValueXrefImpl, StaticAssetDescriptionImpl, StaticAssetImpl, StructuredContentFieldImpl, StructuredContentFieldTemplateImpl, StructuredContentFieldXrefImpl, StructuredContentImpl, StructuredContentItemCriteriaImpl, StructuredContentRuleImpl, StructuredContentTypeImpl, SystemPropertyImpl, TranslationImpl, UpSaleProductImpl, URLHandlerDTO, URLHandlerImpl

public interface MultiTenantCloneable<T>

Describes an entity (or @Embeddable) that is able to be cloned for the purpose of multiple tenancy.

Author:

Jeff Fischer

Method Summary

Methods

Modifier and Type	Method and Description
<G extends T> CreateResponse<G>	createOrRetrieveCopyInstance(MultiTenantCopyContext context) Clone this entity for the purpose of multiple tenancy.

Method Detail

createOrRetrieveCopyInstance

<G extends T> CreateResponse<G> createOrRetrieveCopyInstance(MultiTenantCopyContext context)
                                                         throws CloneNotSupportedException

Clone this entity for the purpose of multiple tenancy. Note, extending classes should follow this pattern:

public CreateResponse<MyClass> createOrRetrieveCopyInstance(MultiTenantCopyContext context) throws CloneNotSupportedException { CreateResponse<MyClass> createResponse = super.createOrRetrieveCopyInstance(context); if (createResponse.isAlreadyPopulated()) { return createResponse; } MyClass myClone = createResponse.getClone(); //copy extended field values on myClone here return createResponse; }

Support should also be added for @Embeddable classes that contribute fields (collections or basic) to a cloneable entity:

public CreateResponse<G extends MyClass> createOrRetrieveCopyInstance(MultiTenantCopyContext context) throws CloneNotSupportedException { CreateResponse createResponse = context.createOrRetrieveCopyInstance(this); MyClass myClone = createResponse.getClone(); //copy extended field values on myClone here return createResponse; }

Parameters:

context - a context object providing persistence and library functionality for copying entities

Returns:

the resulting copy container, possibly already persisted

Throws:

CloneNotSupportedException - if there's a problem detected with the cloning configuration