Cross Reference: /external/chromium_org/sync/internal_api/

This file defines the "sync API", an interface to the syncer
backend that exposes (1) the core functionality of maintaining a consistent
local snapshot of a hierarchical object set; (2) a means to transactionally
access and modify those objects; (3) a means to control client/server
synchronization tasks, namely: pushing local object modifications to a
server, pulling nonlocal object modifications from a server to this client,
and resolving conflicts that may arise between the two; and (4) an
abstraction of some external functionality that is to be provided by the
host environment.

This interface is used as the entry point into the syncer backend
when the backend is compiled as a library and embedded in another
application.  A goal for this interface layer is to depend on very few
external types, so that an application can use the sync backend
without introducing a dependency on specific types.  A non-goal is to
have binary compatibility across versions or compilers; this allows the
interface to use C++ classes.  An application wishing to use the sync API
should ideally compile the syncer backend and this API as part of the
application's own build, to avoid e.g. mismatches in calling convention,
structure padding, or name mangling that could arise if there were a
compiler mismatch.

The schema of the objects in the sync domain is based on the model, which
is essentially a hierarchy of items and folders similar to a filesystem,
but with a few important differences.  The sync API contains fields
such as URL to easily allow the embedding application to store web
browser bookmarks.  Also, the sync API allows duplicate titles in a parent.
Consequently, it does not support looking up an object by title
and parent, since such a lookup is not uniquely determined.  Lastly,
unlike a filesystem model, objects in the Sync API model have a strict
ordering within a parent; the position is manipulable by callers, and
children of a node can be enumerated in the order of their position.
Name	Date	Size
..	12-Mar-2015	4 KiB
attachments/	12-Mar-2015	4 KiB
base_node.cc	12-Mar-2015	10.4 KiB
base_transaction.cc	12-Mar-2015	1 KiB
change_record.cc	12-Mar-2015	1.8 KiB
change_reorder_buffer.cc	12-Mar-2015	7.3 KiB
change_reorder_buffer.h	12-Mar-2015	3.2 KiB
debug_info_event_listener.cc	12-Mar-2015	9.4 KiB
debug_info_event_listener.h	12-Mar-2015	4.6 KiB
debug_info_event_listener_unittest.cc	12-Mar-2015	2.3 KiB
delete_journal.cc	12-Mar-2015	2.2 KiB
DEPS	12-Mar-2015	524
events/	12-Mar-2015	4 KiB
http_bridge.cc	12-Mar-2015	14.8 KiB
http_bridge_network_resources.cc	12-Mar-2015	1.1 KiB
http_bridge_unittest.cc	12-Mar-2015	19.2 KiB
internal_components_factory_impl.cc	12-Mar-2015	3 KiB
js_mutation_event_observer.cc	12-Mar-2015	3.4 KiB
js_mutation_event_observer.h	12-Mar-2015	2.1 KiB
js_mutation_event_observer_unittest.cc	12-Mar-2015	3.7 KiB
js_sync_encryption_handler_observer.cc	12-Mar-2015	4 KiB
js_sync_encryption_handler_observer.h	12-Mar-2015	2.1 KiB
js_sync_encryption_handler_observer_unittest.cc	12-Mar-2015	6.1 KiB
js_sync_manager_observer.cc	12-Mar-2015	3 KiB
js_sync_manager_observer.h	12-Mar-2015	2 KiB
js_sync_manager_observer_unittest.cc	12-Mar-2015	3.7 KiB
protocol_event_buffer.cc	12-Mar-2015	1 KiB
protocol_event_buffer.h	12-Mar-2015	1.1 KiB
protocol_event_buffer_unittest.cc	12-Mar-2015	2.4 KiB
public/	12-Mar-2015	4 KiB
read_node.cc	12-Mar-2015	3.9 KiB
read_transaction.cc	12-Mar-2015	1.8 KiB
README	12-Mar-2015	2 KiB
sync_backup_manager.cc	12-Mar-2015	4.7 KiB
sync_backup_manager.h	12-Mar-2015	2.3 KiB
sync_backup_manager_unittest.cc	12-Mar-2015	6.6 KiB
sync_context.cc	12-Mar-2015	380
sync_context_proxy.cc	12-Mar-2015	352
sync_context_proxy_impl.cc	12-Mar-2015	1.9 KiB
sync_context_proxy_impl.h	12-Mar-2015	2.2 KiB
sync_context_proxy_impl_unittest.cc	12-Mar-2015	3.4 KiB
sync_db_util.cc	12-Mar-2015	1.2 KiB
sync_encryption_handler_impl.cc	12-Mar-2015	67.8 KiB
sync_encryption_handler_impl.h	12-Mar-2015	14 KiB
sync_encryption_handler_impl_unittest.cc	12-Mar-2015	96 KiB
sync_manager_factory.cc	12-Mar-2015	1 KiB
sync_manager_impl.cc	12-Mar-2015	37.6 KiB
sync_manager_impl.h	12-Mar-2015	14.4 KiB
sync_manager_impl_unittest.cc	12-Mar-2015	123 KiB
sync_rollback_manager.cc	12-Mar-2015	4 KiB
sync_rollback_manager.h	12-Mar-2015	1.3 KiB
sync_rollback_manager_base.cc	12-Mar-2015	10.4 KiB
sync_rollback_manager_base.h	12-Mar-2015	5.8 KiB
sync_rollback_manager_base_unittest.cc	12-Mar-2015	2.8 KiB
sync_rollback_manager_unittest.cc	12-Mar-2015	9.3 KiB
syncapi_internal.cc	12-Mar-2015	4 KiB
syncapi_internal.h	12-Mar-2015	1.5 KiB
syncapi_server_connection_manager.cc	12-Mar-2015	3.5 KiB
syncapi_server_connection_manager.h	12-Mar-2015	2.8 KiB
syncapi_server_connection_manager_unittest.cc	12-Mar-2015	4.3 KiB
test/	12-Mar-2015	4 KiB
user_share.cc	12-Mar-2015	356
write_node.cc	12-Mar-2015	18.6 KiB
write_transaction.cc	12-Mar-2015	3.8 KiB