2017 © Pedro Peláez
 

library content-mapping

Mini framework for mapping content from a source to a destination system, e.g. from Propel objects to Solr or from Doctrine entities to ElasticSearch.

image

webfactory/content-mapping

Mini framework for mapping content from a source to a destination system, e.g. from Propel objects to Solr or from Doctrine entities to ElasticSearch.

  • Tuesday, June 7, 2016
  • by webfactory
  • Repository
  • 10 Watchers
  • 5 Stars
  • 610 Installations
  • PHP
  • 5 Dependents
  • 0 Suggesters
  • 1 Forks
  • 0 Open issues
  • 18 Versions
  • 24 % Grown

The README.md

content-mapping

content-mapping is a mini framework for mapping content from a source to a destination system. E.g. from Propel objects to Solr, from Doctrine entities to ElasticSearch or from one XML structure to another. It features interfaces to guide you on your mapping way and ships with some abstract implementation helpers or magic implementations., (*1)

In easy situations, you may want to consider other libraries instead. E.g. if in a Symfony2 project you want to index Doctrine entities in a Solr server, you may want to consider the great floriansemm/solr-bundle. But that and other libraries have shortcomings in more complex situation, e.g. when you want to index attributes of related entities. That's why we present you content-mapping with a more general approach., (*2)

Installation

Add the content-mapping dependency by running the command (see http://getcomposer.org/):, (*3)

php composer.phar require webfactory/content-mapping

and run, (*4)

php composer.phar install

Concept

Class diagram, (*5)

The content-mapping process is based on four parts: the Synchronizer, a SourceAdapter, a Mapper and a DestinationAdapter. The entry point is Synchronizer->synchronize(): there, the Synchronizer gets an Iterator from the SourceAdapter->getObjectsOrderedById() as well as an Iterator from the DestinationAdapter->getObjectsOrderedById(), and compares the objects in each one. During the comparison, it deletes outdated objects (DestinationAdapter->delete()), stores a new objects (DestinationAdapter->createObject()) and updates existing objects in the destination system (Mapper->map())., (*6)

DestinationAdapter->updated() and DestinationAdapter->commit() are only hooks for external change tracking, to say an object has been updated or both Iterators have been processed, i.e. changes can be persisted., (*7)

Usage

To construct a Synchronizer, you need implementations for the SourceAdaper, Mapper and DestinationAdapter. Please find abstract templates and ready-to-use generic implementations of SourceAdapters and DestinationAdapters in the webfactory/content-mapping-* packages. The Mapper usually is very specific for your project, so you probably want to implement it in your application., (*8)

use Webfactory\ContentMapping\Synchronizer;
use Webfactory\ContentMapping\SourceAdapter\Propel\GenericPropelSourceAdapter;

$sourceAdapter = ...; // see the readme of the corresponding package on how to construct it
$mapper = ...; // construct your own implementation
$destinationAdapter = ...; // see the readme of the corresponding package on how to construct it
$logger = ...; // just a PSR-3 logger

$classNameToSynchronize = 'MyClass';
$force = false; // if true, objects in destination system will be updated even if no changes are detected

$synchronizer = new Synchronizer($sourceAdapter, $mapper, $destinationAdapter, $logger);
$synchronizer->synchronize($classNameToSynchronize, $force);

This project was started at webfactory GmbH, Bonn., (*9)

Copyright 2015-2022 webfactory GmbH, Bonn. Code released under the MIT license., (*10)

The Versions

07/06 2016

dev-master

9999999-dev

Mini framework for mapping content from a source to a destination system, e.g. from Propel objects to Solr or from Doctrine entities to ElasticSearch.

  Sources   Download

MIT

The Requires

 

The Development Requires

by webfactory GmbH

25/05 2016

3.2.0

3.2.0.0

Mini framework for mapping content from a source to a destination system, e.g. from Propel objects to Solr or from Doctrine entities to ElasticSearch.

  Sources   Download

MIT

The Requires

 

The Development Requires

by webfactory GmbH

19/05 2016

3.1.0

3.1.0.0

Mini framework for mapping content from a source to a destination system, e.g. from Propel objects to Solr or from Doctrine entities to ElasticSearch.

  Sources   Download

MIT

The Requires

 

The Development Requires

by webfactory GmbH

30/11 2015

2.x-dev

2.9999999.9999999.9999999-dev

Mini framework for mapping content from a source to a destination system, e.g. from Propel objects to Solr or from Doctrine entities to ElasticSearch.

  Sources   Download

MIT

The Requires

 

The Development Requires

by webfactory GmbH

30/11 2015

2.0.1

2.0.1.0

Mini framework for mapping content from a source to a destination system, e.g. from Propel objects to Solr or from Doctrine entities to ElasticSearch.

  Sources   Download

MIT

The Requires

 

The Development Requires

by webfactory GmbH

19/11 2015

1.x-dev

1.9999999.9999999.9999999-dev

  Sources   Download

The Requires

  • webfactory/pdf-text-extraction 1.0.*

 

19/11 2015

1.0.8

1.0.8.0

  Sources   Download

The Requires

  • webfactory/pdf-text-extraction 1.0.*

 

27/08 2015

3.0.1

3.0.1.0

Mini framework for mapping content from a source to a destination system, e.g. from Propel objects to Solr or from Doctrine entities to ElasticSearch.

  Sources   Download

MIT

The Requires

 

The Development Requires

by webfactory GmbH

10/08 2015

3.0.0

3.0.0.0

Mini framework for mapping content from a source to a destination system, e.g. from Propel objects to Solr or from Doctrine entities to ElasticSearch.

  Sources   Download

MIT

The Requires

 

The Development Requires

by webfactory GmbH

31/07 2015

2.0.0

2.0.0.0

Mini framework for mapping content from a source to a destination system, e.g. from Propel objects to Solr or from Doctrine entities to ElasticSearch.

  Sources   Download

MIT

The Requires

 

The Development Requires

by webfactory GmbH

29/11 2012

1.0.7

1.0.7.0

  Sources   Download

The Requires

  • webfactory/pdf-text-extraction 1.0.*

 

29/03 2012

1.0.6

1.0.6.0

  Sources   Download

The Requires

  • webfactory/pdf-text-extraction 1.0.3

 

28/03 2012

1.0.5

1.0.5.0

  Sources   Download

The Requires

  • webfactory/pdf-text-extraction 1.0.2

 

21/03 2012

1.0.4

1.0.4.0

  Sources   Download

The Requires

  • webfactory/pdf-text-extraction 1.0.2

 

21/03 2012

1.0.3

1.0.3.0

  Sources   Download

The Requires

  • webfactory/pdf-text-extraction 1.0.*

 

21/03 2012

1.0.2

1.0.2.0

  Sources   Download

The Requires

  • webfactory/pdf-text-extraction 1.0.*

 

21/03 2012

1.0.1

1.0.1.0

  Sources   Download

The Requires

  • webfactory/pdf-text-extraction 1.0.*

 

21/03 2012

1.0.0

1.0.0.0

  Sources   Download

The Requires

  • webfactory/pdf-text-extraction 1.0.*