You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2015/05/15 20:24:35 UTC
[1/6] isis git commit: ISIS-1133: adocs ... break out services into
API vs SPI; using tocify; a bit more on testing.
Repository: isis
Updated Branches:
refs/heads/master 65d34db7d -> ec058a8de
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_aaa.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_aaa.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_aaa.adoc
deleted file mode 100644
index 671a677..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_aaa.adoc
+++ /dev/null
@@ -1,403 +0,0 @@
-= Summary
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-
-IMPORTANT: TODO - briefly discuss the different types of services
-
-== Applib Services
-
-The table below summarizes all the APIs defined by Apache Isis. It also lists their corresponding implementation, either a default implementation provided by Isis itself, or provided by one of the in http://isisaddons.org[Isis Addons] (non-ASF)modules.
-
-.Domain Services
-[cols="2,4a,1,1", options="header"]
-|===
-
-|API
-|Maven Module +
-Impl'n (g: a:)
-|Implementation
-|Notes
-
-|<<__code_actioninvocationcontext_code, `o.a.i.applib.` +
-`services.actinv` +
-`ActionInvocationContext`>>
-|``o.a.i.core`` +
-``isis-core-applib``
-|`ActionInvocationContext`
-|API is also concrete class
-
-|<<__code_auditingservice3_code, `o.a.i.applib.` +
-`services.audit` +
-`AuditingService3`>>
-|``o.ia.m.audit`` +
-``isis-module-audit``
-|`AuditingService`
-|related services:
-`AuditingService-` +
-`Contributions`,
-`AuditingService-` +
-`Repository`
-
-|<<__code_backgroundcommandservice_code, `o.a.i.applib.` +
-`services.background` +
-`BackgroundCommandService`>>
-|``o.ia.m.command`` +
-``isis-module-command``
-|`BackgroundCommandServiceJdo`
-|related services:
-`BackgroundCommandService-` +
-`JdoContributions`,
-`BackgroundCommandService-` +
-`JdoRepository`
-
-|<<__code_backgroundservice_code, `o.a.i.applib.` +
-`services.background` +
-`BackgroundService`>>
-|``o.a.i.core`` +
-``isis-core-runtime``
-|`BackgroundServiceDefault`
-|depends on: +
-`BackgroundCommandService`
-
-|<<__code_bookmarkservice_code, `o.a.i.applib.` +
-`services.bookmark` +
-`BookmarkService`>>
-|``o.a.i.core`` +
-``isis-core-metamodel``
-|`BookmarkServiceDefault`
-|related services:
-`BookmarkHolder-` ++
-`ActionContributions`,
-`BookmarkHolder-` ++
-`AssociationContributions`
-
-|<<__code_classdiscoveryservice_code, `o.a.i.applib.` +
-`services.classdiscovery` +
-`ClassDiscoveryService`>>
-|``o.a.i.core`` +
-``isis-core-applib``
-|`ClassDiscoveryService-` +
-`UsingReflections`
-|requires `org.reflections:reflections` as Maven dependency
-
-|<<__code_clockservice_code, `o.a.i.applib.` +
-`services.clock` +
-`ClockService`>>
-|``o.a.i.core`` +
-``isis-core-applib``
-|`ClockService`
-|API is also a concrete class.
-
-|<<__code_commandcontext_code, `o.a.i.applib.` +
-`services.command` +
-`CommandContext`>>
-|``o.a.i.core`` +
-``isis-core-applib``
-|`CommandContext`
-|API is also a concrete class. +
-depends on: +
-`CommandService` for persistent `Command`, else in-memory impl. used
-
-|<<__code_commandservice_code, `o.a.i.applib.` +
-`services.command.spi` +
-`CommandService`>>
-|``o.ia.m.command`` +
-``isis-module-command``
-|`CommandServiceJdo`
-|related services: +
-`CommandService-` ++
-`JdoContributions`,
-`CommandService-` ++
-`JdoRepository`
-
-|<<__code_deeplinkservice_code, `o.a.i.applib` +
-`services.deeplink` +
-`DeepLinkService`>>
-|``o.a.i.viewer`` +
-``isis-viewer-wicket-impl``
-|`DeepLinkServiceWicket`
-|Implementation only usable within Wicket viewer
-
-|<<__code_domainobjectcontainer_code, `o.a.i.applib` +
-`DomainObjectContainer`>>
-|``o.a.i.core`` +
-``isis-core-metamodel``
-|`DomainObjectContainerDefault`
-|
-
-|<<__code_emailnotificationservice_code, `o.a.i.applib.` +
-`services.userreg` +
-`EmailNotificationService`>>
-|``o.a.i.core`` +
-``isis-core-runtime``
-|`EmailNotificationService-` ++
-`Default`
-|depends on: +
-a configured `EmailService`
-
-|<<__code_emailservice_code, `o.a.i.applib.` +
-`services.email` +
-`EmailService`>>
-|``o.a.i.core`` +
-``isis-core-runtime``
-|`EmailServiceDefault`
-|
-
-|<<__code_eventbusservice_code, `o.a.i.applib.` +
-`services.eventbus` +
-`EventBusService`>>
-|``o.a.i.core`` +
-``isis-core-objectstore-jdo-datanucleus``
-|`EventBusServiceJdo`
-|
-
-|<<__code_eventserializer_code, `o.a.i.applib.` +
-`services.publish` +
-`EventSerializer`>>
-|``o.ia.m.publishing`` +
-``isis-module-publishing``
-|`RestfulObjects-` +
-`SpecEventSerializer`
-|
-
-|<<__code_exceptionrecognizer_code, `o.a.i.applib.` +
-`services.exceprecog` +
-`ExceptionRecognizer`>>
-|``o.a.i.core`` +
-``isis-core-applib``
-|`ExceptionRecognizer-` +
-`CompositeFor-` +
-`JdoObjectStore`
-|Extensible using composite pattern if required
-
-|<<__code_fixturescripts_code, `o.a.i.applib.` +
-`fixturescripts` +
-`FixtureScripts`>>
-|``o.a.i.core`` +
-``isis-core-applib``
-|(abstract class)
-|depends on: +
-`ClassDiscoveryService`
-
-|<<__code_guicebeanprovider_code, `o.a.i.applib.` +
-`services.guice` +
-`GuiceBeanProvider`>>
-|``o.a.i.core`` +
-``isis-viewer-wicket-impl``
-|`GuiceBeanProviderWicket`
-|
-
-|<<__code_isisjdosupport_code, `o.a.i.applib.` +
-`services.jdosupport` +
-`IsisJdoSupport`>>
-|``o.a.i.core`` +
-``isis-core-objectstore-jdo-datanucleus``
-|`IsisJdoSupportImpl`
-|
-
-|<<__code_localeprovider_code, `o.a.i.applib.` +
-`services.i18n` +
-`LocaleProvider`>>
-|``o.a.i.viewer`` +
-``isis-viewer-wicket-impl``
-|`LocaleProviderWicket`
-|
-
-|<<__code_mementoservice_code, `o.a.i.applib.` +
-`services.memento` +
-`MementoService`>>
-|``o.a.i.core`` +
-``isis-core-runtime``
-|`MementoServiceDefault`
-|
-
-|<<__code_metamodelservice_code, `o.a.i.applib.` +
-`services.metamodel` +
-`MetaModelService`>>
-|``o.a.i.core`` +
-``isis-core-metamodel``
-|`MetaModelServiceDefault`
-|
-
-|<<__code_publishingservice_code, `o.a.i.applib.` +
-`services.publish` +
-`PublishingService`>>
-|``o.ia.m.publishing`` +
-``isis-module-publishing``
-|`PublishingService`
-|related services:
-`PublishingService-` ++
-`Contributions`,
-`PublishingService-` ++
-`Repository`. +
-depends on: +
-`EventSerializer`
-
-|<<__code_queryresultscache_code, `o.a.i.applib.` +
-`services.` +
-`queryresultscache` +
-`QueryResultsCache`>>
-|``o.a.i.core`` +
-``isis-core-applib``
-|`QueryResultsCache`
-|API is also a concrete class
-
-|<<__code_scratchpad_code, `o.a.i.applib.` +
-`services.scratchpad` +
-`Scratchpad`>>
-|``o.a.i.core`` +
-``isis-core-applib``
-|`Scratchpad`
-|API is also a concrete class
-
-|<<__code_scratchpad_code, `o.a.i.applib.` +
-`services.sudo` +
-`SudoService`>>
-|``o.a.i.core`` +
-``isis-core-runtime``
-|`SudoServiceDefault`
-|API is also a concrete class
-
-|<<__code_translationservice_code, `o.a.i.applib.` +
-`services.i18n` +
-`TranslationService`>>
-|``o.a.i.core`` +
-``isis-core-runtime``
-|`TranslationServicePo`
-|related services: `TranslationServicePoMenu` +
-depends on: +
-`TranslationsResolver`, `LocaleProvider`
-
-|<<__code_translationsresolver_code, `o.a.i.applib.` +
-`services.i18n` +
-`TranslationsResolver`>>
-|``o.a.i.viewer`` +
-``isis-viewer-wicket-impl``
-|`TranslationsResolverWicket`
-|
-
-|<<__code_userprofileservice_code, `o.a.i.applib.` +
-`services.userprof` +
-`UserProfileService`>>
-|
-|
-|SPI only
-
-|<<__code_userregistrationservice_code, `o.a.i.applib.` +
-`services.userreg` +
-`UserRegistrationService`>>
-|``o.ia.m.security`` +
-``isis-module-security``
-|`SecurityModule-` +
-`AppUserRegistrationService`
-|depends (implicitly) on: +
-a configured `EmailService`
-
-|<<__code_wrapperfactory_code, `o.a.i.applib.` +
-`services.wrapper` +
-`WrapperFactory`>>
-|``o.a.i.core`` +
-``isis-core-wrapper``
-|`WrapperFactoryDefault`
-|
-
-|<<__code_xmlsnapshotservice_code, `o.a.i.applib.` +
-`services.xmlsnapshot` +
-`XmlSnapshotService`>>
-|``o.a.i.core`` +
-``isis-core-runtime``
-|`XmlSnapshotServiceDefault`
-|
-
-|===
-
-Key:
-
-* `o.a.i` is an abbreviation for `org.apache.isis`
-* `o.ia.m` is an abbreviation for `org.isisaddons.module`
-
-
-All domain services are automatically registered (annotated with <<__code_domainservice_code, `@DomainService`>> except:
-
-* `FixtureScripts` +
-+
-Subclass and either annotate with `@DomainService` or register in `isis.properties`
-
-* `ExceptionRecognizer` +
-+
-Register explicitly in isis.properties (so is extensible)
-
-
-
-
-
-== "Internal" APIs/SPIs
-
-These services definitions depend on the internals of the framework; we do not guarantee that semver will be honoured for these APIs.
-
-.Semi-public SPI
-[cols="3,3,2,2a", options="header"]
-|===
-
-|API
-|Maven Module +
-Impl'n (g: a:)
-|Implementation
-|Notes
-
-
-|<<__code_contentmappingservice_code, `o.a.i.v.ro.` +
-`rendering.service.conneg.` +
-`ContentMappingService`>>
-|
-|
-|SPI only, no default implementation.
-
-|<<__code_contentnegotiationservice_code, `o.a.i.v.ro.` +
-`rendering.service.conneg.` +
-`ContentNegotiationService`>>
-|``o.a.i.core`` +
-`isis-core-viewer-restfulobjects-rendering`
-|`ContentNegotiationService-` +
-`XRoDomainType`
-|
-
-|===
-
-Key:
-
-* `o.a.i.v.ro` is an abbreviation for `org.apache.isis.viewer.restfulobjects`
-
-
-
-
-
-== Deprecated Services
-
-There is also a number of deprecated domain services.
-
-.Deprecated Domain Services
-[cols="2,4a,1,1", options="header"]
-|===
-
-|API
-|Maven Module +
-Impl'n (g: a:)
-|Implementation
-|Notes
-
-|`o.a.i.applib.annotation`
-`Bulk.InteractionContext`
-|g:`o.a.i.core`
-a:`isis-core-applib`
-|`Bulk.InteractionContext`
-|Replaced by `ActionInvocationContext`
-
-
-|===
-
-Key:
-* `o.a.i` is an abbreviation for `org.apache.isis`
-* `o.ia.m` is an abbreviation for `org.isisaddons.module`
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_action-invocation-context.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_action-invocation-context.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_action-invocation-context.adoc
deleted file mode 100644
index 989d131..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_action-invocation-context.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `ActionInvocationContext`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_auditing-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_auditing-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_auditing-service.adoc
deleted file mode 100644
index e4626d2..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_auditing-service.adoc
+++ /dev/null
@@ -1,13 +0,0 @@
-= `AuditingService3`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
-
-
-== Isis Addons Implementation
-
-For 1.7.0+, see the http://github.com/isisaddons/isis-module-audit[Isis addons' Audit module] (non-ASF).
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_background-command-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_background-command-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_background-command-service.adoc
deleted file mode 100644
index 3111628..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_background-command-service.adoc
+++ /dev/null
@@ -1,12 +0,0 @@
-= `BackgroundCommandService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
-== Isis Addons Implementation
-
-For 1.7.0+, see the http://github.com/isisaddons/isis-module-command[Isis addons' Command module] (non-ASF).
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_background-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_background-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_background-service.adoc
deleted file mode 100644
index 74c69e5..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_background-service.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `BackgroundService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_bookmark-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_bookmark-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_bookmark-service.adoc
deleted file mode 100644
index 5d0024a..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_bookmark-service.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `BookmarkService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_class-discovery-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_class-discovery-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_class-discovery-service.adoc
deleted file mode 100644
index 075cf62..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_class-discovery-service.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `ClassDiscoveryService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_clock-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_clock-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_clock-service.adoc
deleted file mode 100644
index 1b4675d..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_clock-service.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `ClockService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_command-context.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_command-context.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_command-context.adoc
deleted file mode 100644
index 15c250c..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_command-context.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `CommandContext`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_command-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_command-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_command-service.adoc
deleted file mode 100644
index ab86189..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_command-service.adoc
+++ /dev/null
@@ -1,11 +0,0 @@
-= `CommandService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
-== Isis Addons Implementation
-
-For 1.7.0+, see the http://github.com/isisaddons/isis-module-command[Isis addons' Command module] (non-ASF).
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_content-mapping-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_content-mapping-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_content-mapping-service.adoc
deleted file mode 100644
index 09d20f9..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_content-mapping-service.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `ContentMappingService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_content-negotiation-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_content-negotiation-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_content-negotiation-service.adoc
deleted file mode 100644
index 89933f9..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_content-negotiation-service.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `ContentNegotiationService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_deep-link-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_deep-link-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_deep-link-service.adoc
deleted file mode 100644
index 7135b31..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_deep-link-service.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `DeepLinkService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_domain-object-container.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_domain-object-container.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_domain-object-container.adoc
deleted file mode 100644
index 53d253f..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_domain-object-container.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `DomainObjectContainer`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_email-notification-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_email-notification-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_email-notification-service.adoc
deleted file mode 100644
index 2a99016..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_email-notification-service.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `EmailNotificationService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_email-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_email-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_email-service.adoc
deleted file mode 100644
index 6f78302..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_email-service.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `EmailService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_event-bus-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_event-bus-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_event-bus-service.adoc
deleted file mode 100644
index 43275fe..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_event-bus-service.adoc
+++ /dev/null
@@ -1,15 +0,0 @@
-= `EventBusService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-## Implementation
-
-IMPORTANT: TODO
-
-## Registration
-
-The `EventBusServiceJdo` class provides the default implementation and (as of 1.6.0+) is automatically registered using `@DomainService`. No further configuration is necessary.
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_event-serializer.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_event-serializer.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_event-serializer.adoc
deleted file mode 100644
index 2c20560..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_event-serializer.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `EventSerializer`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_exception-recognizer.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_exception-recognizer.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_exception-recognizer.adoc
deleted file mode 100644
index 04e7561..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_exception-recognizer.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `ExceptionRecognizer`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_fixture-scripts.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_fixture-scripts.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_fixture-scripts.adoc
deleted file mode 100644
index f7cd2e2..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_fixture-scripts.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `FixtureScripts`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_guice-bean-provider.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_guice-bean-provider.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_guice-bean-provider.adoc
deleted file mode 100644
index 99f4f36..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_guice-bean-provider.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `GuiceBeanProvider`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_isis-jdo-support.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_isis-jdo-support.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_isis-jdo-support.adoc
deleted file mode 100644
index 3c1873a..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_isis-jdo-support.adoc
+++ /dev/null
@@ -1,129 +0,0 @@
-= `IsisJdoSupport`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-
-The `IsisJdoSupport` service provides a number of general purpose methods for working with the JDO/DataNucleus objectstore.
-
-
-== API
-
-The API provided by `IsisJdoSupport` is:
-
-[source,java]
-----
-public interface IsisJdoSupport {
- List<Map<String, Object>> executeSql(String sql);
- Integer executeUpdate(String sql);
- void deleteAll(Class<?>... pcClasses);
- <T> T refresh(T domainObject);
- void ensureLoaded(Collection<?> collectionOfDomainObjects);
- PersistenceManager getJdoPersistenceManager();
-}
-----
-
-Each of these methods are discussed in more details below.
-
-
-== Executing arbitrary SQL
-
-The `executeSql(...)` method allows arbitrary queries to be submitted:
-
-[source,java]
-----
-List<Map<String, Object>> results = isisJdoSupport.executeSql("select * from custMgmt.customers");
-----
-
-The result set is automatically converted into a list of maps, where the map key is the column name.
-
-
-In a similar manner, the `executeUpdate(...)` allows arbitrary updates to be performed.
-
-[source,java]
-----
-int count = isisJdoSupport.executeUpdate("select count(*) from custMgmt.customers);
-----
-
-The returned value is the number of rows updated.
-
-
-
-== Fixture support
-
-The `deleteAll(...)` method is provided pretty much exclusively for tearing down fixture data:
-
-[source,java]
-----
-deleteAll(Order.class);
-deleteAll(CustomerAddress.class);
-deleteAll(Customer.class);
-----
-
-[NOTE]
-====
-It can occasionally be the case that Isis' internal adapter for the domain object is
-still in memory. JDO/DataNucleus seems to bump up the version of the object prior to its deletion,
-which under normal circumstances would cause Isis to throw a concurrency exception. Therefore
-to prevent this from happening (ie to <i>force</i> the deletion of all instances), concurrency checking
-is temporarily disabled while this method is performed.
-====
-
-
-
-== Reloading entities
-
-A http://www.datanucleus.org/products/datanucleus/jdo/orm/relationships.html[known limitation] of DataNucleus' implementation of JDO is that persisting a child entity (in a 1:n bidirectional relationship) does not cause the parent's collection to be updated.
-
-The `refresh(T domainObject)` method can be used to reload the parent object (or indeed any object).
-
-For example:
-
-[source,java]
-----
-public Order newOrder(final Customer customer) {
- Order order = newTransientInstance(Order.class);
- order.setCustomer(customer);
- persist(customer);
- getContainer().flush(); // <1>
- isisJdoSupport.refresh(customer); // <2>
- return order;
-}
-----
-<1> flush to database
-<2> reload parent from database
-
-
-[NOTE]
-====
-The particular example that led to this method being added was a 1:m bidirectional relationship,
-analogous to `Customer <-> * Order`. Persisting the child `Order` object did not cause
-the parent ``Customer``'s collection of orders to be updated. In fact, JDO does not make any
-such guarantee to do so. Options are therefore either to maintain the collection in code, or to
-refresh the parent.
-
-====
-
-
-
-
-== Using JDO `PersistenceManager` directly
-
-Apache Isis provides a simplified API on top of only supports JDO, and so does not support all of JDO's features. For example, Isis (currently) only supports named queries. If you require more flexibility than this, eg for dynamically constructed queries, then the service provides access to the underlying JDO `PersistenceManager` API:
-
-[source,java]
-----
-public List<Order> findOrders(...) {
- javax.jdo.PersistenceManager pm = isisJdoSupport.getPersistenceManager();
-
- // knock yourself out...
-
- return someListOfOrders;
-}
-----
-
-
-
-== Registering the Service
-
-The `IsisJdoSupportImpl` class provides the default implementation and (as of 1.6.0+) is automatically registered using `@DomainService`. No further configuration is necessary.
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_locale-provider.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_locale-provider.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_locale-provider.adoc
deleted file mode 100644
index 4956f49..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_locale-provider.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `LocaleProvider`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_memento-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_memento-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_memento-service.adoc
deleted file mode 100644
index f06a824..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_memento-service.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `MementoService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_metamodel-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_metamodel-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_metamodel-service.adoc
deleted file mode 100644
index cb298dc..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_metamodel-service.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `MetamodelService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_publishing-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_publishing-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_publishing-service.adoc
deleted file mode 100644
index 93b17c1..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_publishing-service.adoc
+++ /dev/null
@@ -1,11 +0,0 @@
-= `PublishingService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
-== Isis Addons Implementation
-
-For 1.7.0+, see the http://github.com/isisaddons/isis-module-publishing[Isis addons' Publishing module] (non-ASF).
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_query-results-cache.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_query-results-cache.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_query-results-cache.adoc
deleted file mode 100644
index 0b22d23..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_query-results-cache.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `QueryResultsCache`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_scratch-pad.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_scratch-pad.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_scratch-pad.adoc
deleted file mode 100644
index 0a11596..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_scratch-pad.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `ScratchPad`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_sudo-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_sudo-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_sudo-service.adoc
deleted file mode 100644
index bb33642..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_sudo-service.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `SudoService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_translation-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_translation-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_translation-service.adoc
deleted file mode 100644
index 0c1b16e..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_translation-service.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `TranslationService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_translations-resolver.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_translations-resolver.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_translations-resolver.adoc
deleted file mode 100644
index 7148bc7..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_translations-resolver.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `TranslationsResolver`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_user-profile-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_user-profile-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_user-profile-service.adoc
deleted file mode 100644
index 6b56835..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_user-profile-service.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `UserProfileService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_user-registration-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_user-registration-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_user-registration-service.adoc
deleted file mode 100644
index ab1a666..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_user-registration-service.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `UserRegistrationService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_wrapper-factory.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_wrapper-factory.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_wrapper-factory.adoc
deleted file mode 100644
index 75e9d25..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_wrapper-factory.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `WrapperFactory`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_xml-snapshot-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_xml-snapshot-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_xml-snapshot-service.adoc
deleted file mode 100644
index f82a24a..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services_xml-snapshot-service.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `XmlSnapshotService`
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_superclasses.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_superclasses.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_superclasses.adoc
new file mode 100644
index 0000000..d9aaee1
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_superclasses.adoc
@@ -0,0 +1,52 @@
+= Superclasses
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
+The table below summarizes all the convenience superclasses defined by Apache Isis.
+
+.Convenience Superclasses
+[cols="2,4a,1,1", options="header"]
+|===
+
+|API
+|Maven Module +
+Impl'n (g: a:)
+|Implementation
+|Notes
+
+
+|<<__code_fixturescripts_code, `o.a.i.applib.` +
+`fixturescripts` +
+`FixtureScripts`>>
+|``o.a.i.core`` +
+``isis-core-applib``
+|(abstract class)
+|depends on: +
+`ClassDiscoveryService`
+
+
+
+|===
+
+
+
+
+include::_user-guide_reference_superclasses_fixture-scripts.adoc[leveloffset=+1]
+
+
+
+== `AbstractDomainObject`
+
+IMPORTANT: TODO
+
+== `AbstractDomainService`
+
+IMPORTANT: TODO
+
+== `AbstractFactoryAndRepository`
+
+IMPORTANT: TODO
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_superclasses_fixture-scripts.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_superclasses_fixture-scripts.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_superclasses_fixture-scripts.adoc
new file mode 100644
index 0000000..f7cd2e2
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_superclasses_fixture-scripts.adoc
@@ -0,0 +1,8 @@
+= `FixtureScripts`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_testing_integ-test-support_wrapper-factory.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_testing_integ-test-support_wrapper-factory.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_testing_integ-test-support_wrapper-factory.adoc
index e6de1e8..223d6d9 100644
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_testing_integ-test-support_wrapper-factory.adoc
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_testing_integ-test-support_wrapper-factory.adoc
@@ -11,6 +11,8 @@ The `WrapperFactory` service is responsible for wrapping a domain object in a dy
`WrapperFactory` uses link:javassist.org[javassist] to perform its magic; this is the same technology that ORMs such as link:http://hibernate.org/[Hibernate] use to manage lazy loading/dirty tracking (DataNucleus uses a different mechanism).
====
+
+
It does this by allowing through method invocations that would be allowed if the user were interacting with the domain object through one of the viewers, but throwing an exception if the user attempts to interact with the domain object in a way that would not be possible if using the UI.
The mechanics are as follows:
@@ -25,51 +27,125 @@ The mechanics are as follows:
. if the business rule checks pass, then the underlying member is invoked. Otherwise an exception is thrown.
-The type of exception depends upon what sort of check failed. It's straightforward enough: if the member is invisible then a `HiddenException` is thrown; if it's not usable then you'l get a `DisabledException`, if the args are not valid then catch an `InvalidException`.
+The type of exception depends upon what sort of check failed. It's straightforward enough: if the member is invisible then a `HiddenException` is thrown; if it's not usable then you'll get a `DisabledException`, if the args are not valid then catch an `InvalidException`.
image::{_imagesdir}testing/wrapper-factory.png[width="600px"]
-Let's look in a bit more deatil at what the test can do with the wrapper.
+Let's look in a bit more detail at what the test can do with the wrapper.
+
+
+
+
+== Wrapping and Unwrapping
+
+Wrapping a domain object is very straightforward; simply call `WrapperFactory#wrap(...)`.
+
+For example:
+
+[source,java]
+----
+Customer customer = ...;
+Customer wrappedCustomer = wrapperFactory.wrap(wrappedCustomer);
+----
+
+
+Going the other way -- getting hold of the underlying (wrapped) domain object -- is just as easy; call `WrapperFactory#unwrap(...)`.
+
+For example:
-== Methods
+[source,java]
+----
+Customer wrappedCustomer = ...;
+Customer customer = wrapperFactory.unwrap(wrappedCustomer);
+----
+
+If you prefer, you also can get the underlying object from the wrapper itself, by downcasting to `WrappingObject` and calling `__isis_wrapped()` method:
+
+[source,java]
+----
+Customer wrappedCustomer = ...;
+Customer customer = (Customer)((WrappingObject)wrappedCustomer).__isis_wrapped());
+----
+
+We're not sure that's any easier (in fact we're certain it looks rather obscure). Stick with calling `unwrap(...)`!
+
+
+
+
+== Using the wrapper
As the wrapper is intended to simulate the UI, only those methods that correspond to the "primary" methods of the domain object's members are allowed to be called. That means:
-* for object properties the test can call the getter or setter method
+* for *_object properties_* the test can call the getter or setter method
-* for object collections the test can call the getter. +
+* for *_object collections_* the test can call the getter. +
+
-If there is a supporting `addTo(...)` or `removeFrom(...)` method, then these can be called. It can also call `add(...)` or `remove(...)` on the collection (returned by the gettter) itself. +
+If there is a supporting `addTo...()` or `removeFrom...()` method, then these can be called. It can also call `add(...)` or `remove(...)` on the collection (returned by the gettter) itself. +
+
[NOTE]
====
In this respect the wrapper is more functional than the <<_wicket_viewer, Wicket viewer>> (which does not expose the ability to mutate collections directly).
====
-* for object actions the test can call the action method itself.
+* for *_object actions_* the test can call the action method itself.
+
+As a convenience, we also allow the test to call any `default...()`,`choices...()` or `autoComplete...()` method. These are often useful for obtaining a valid value to use.
+
+What the test can't call is any of the remaining supporting methods, such as `hide...()`, `disable...()` or `validate...()`. That's because their value is implied by the exception being thrown.
+
+The wrapper _does_ also allow the object's `title()` method or its `toString()` , however this is little use for objects whose title is built up using the `@Title` annotation. Instead, we recommend that your test verifies an object's title by calling `DomainObjectContainer#titleOf(...)` method.
+
-As a convenience, we also allow the test to call any `defaultXxx()`, `choicesXxx()` or `autoCompleteXxx()` method. These are often useful for obtaining a valid value to use.
-What the test can't call is any of the remaining supporting methods, such as `hideXxx()`, `disableXxx()` or `validateXxx`. That's because their value is implied by the exception being thrown.
-The wrapper does also allow the object's `title()` method or its `toString()` method to be called, however this is of no use for objects whose title is built up using the `@Title` annotation.
+== Firing Domain Events
+As well as enforcing business rules, the wrapper has another important feature, namely that it will cause domain events to be fired.
+For example, if we have an action annotated with `@Action(domainEvent=...`):
-obtaining the wrapper from the proxy.
+[source,java]
+----
+public class ToDoItem ... {
+ @Action(
+ domainEvent =CompletedEvent.class
+ )
+ public ToDoItem completed() { ... }
+ ...
+}
+----
+then invoking the action through the proxy will cause the event (`CompletedEvent` above) to be fired to any subscribers. A test might therefore look like:
-can only invoke methods that correspond to members of the Isis metamodel. Can't call supporting methods (such as disable, hide etc).
+[source,java]
+----
+@Inject
+private EventBusService eventBusService;
-that it receives (the method invoked)
+@Test
+public void subscriberReceivesEvents() throws Exception {
+ // given
+ final ToDoItem.CompletedEvent[] evHolder = new ToDoItem.CompletedEvent[1];
+ eventBusService.register(new Object() {
+ @Subscribe
+ public void on(final ToDoItem.CompletedEvent ev) {
+ evHolder[0] = ev;
+ }
+ });
-The wrapper
+ // when
+ toDoItem.completed();
+ // then
+ then(evHolder[0].getSource()).isEqualTo(unwrap(toDoItem));
+ then(evHolder[0].getIdentifier().getMemberName()).isEqualTo("completed");
+}
+----
-* also triggers domain events
+The wrapper will also fire domain events for properties (if annotated with `@Property(domainEvent=...)`) or collections (if annotated with `@Collection(domainEvent=...)`).
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/template/document.html.erb
----------------------------------------------------------------------
diff --git a/adocs/template/document.html.erb b/adocs/template/document.html.erb
index 739b29d..f726158 100644
--- a/adocs/template/document.html.erb
+++ b/adocs/template/document.html.erb
@@ -169,6 +169,27 @@
</style>
<style>
+
+ body div#toc .tocify-subheader li {
+ font-size: 14px;
+ }
+ body div#toc .tocify li, .tocify ul {
+ line-height: 20px;
+ }
+
+ body div#toc li.tocify-item.active:before,
+ body div#toc2 li.tocify-item.active:before {
+ content: "\00BB \0020";
+ margin-left: -12px;
+ }
+
+ body div#toc li.tocify-item.active a,
+ body div#toc2 li.tocify-item.active a {
+ color: red;
+ }
+ </style>
+
+ <style>
footer {
margin-top: 1000px;
}
@@ -266,12 +287,21 @@
*/
.header--hidden
{
+ /*
-webkit-transform: translateY( -100% );
-ms-transform: translateY( -100% );
transform: translateY( -100% );
+ */
}
</style>
+ <style>
+ .tocify {
+ margin-top: 80px;
+ }
+ </style>
+
+
</script>
</head>
@@ -399,7 +429,9 @@
<div class="large-3 medium-3 xcolumns">
<div id="toc" class="<%= attr 'toc-class', 'toc2' %>">
- <%= converter.convert_with_options @document, 'outline', :toclevels => 6 %>
+ <div class="fallback-toc">
+ <%= converter.convert_with_options @document, 'outline', :toclevels => 4 %>
+ </div>
</div>
</div>
@@ -410,14 +442,36 @@
<script src="<%= (attr :_basedir) %>js/foundation/5.5.1/foundation.min.js"></script>
+<!-- Tocify - nice dynamic autoscrolling TOC -->
+<link href="https://cdnjs.cloudflare.com/ajax/libs/jquery.tocify/1.9.0/stylesheets/jquery.tocify.min.css" rel="stylesheet">
+<script src="https://code.jquery.com/jquery-1.11.3.min.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/jqueryui/1.11.4/jquery-ui.min.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery.tocify/1.9.0/javascripts/jquery.tocify.min.js"></script>
+
+
<script type="text/javascript">
+ $(function () {
+ $("#toc").tocify({
+ scrollTo: 50,
+ extendPage: true,
+ context: "#doc-content",
+ highlightOnScroll: true,
+ hashGenerator: "pretty",
+ hideEffect: "slideUp",
+ selectors: "h2,h3,h4,h5"
+ });
+ $(".fallback-toc").hide();
+ });
+</script>
+
+<xscript type="text/javascript">
$(document).foundation();
$(document).ready(function(){
// Cache selectors
var lastId,
topMenu = $("div#toc ul"),
- topMenuHeight = 70,
+ topMenuHeight = 100,
menuItems = topMenu.find("a"),
menuItemsHrefs = menuItems.map(function(){
@@ -454,8 +508,6 @@
if (lastId !== id && id) {
scrollTo(id);
- $(".header").addClass("header--hidden");
-
}
window.history.pushState({}, "", window.location.origin + window.location.pathname + "#" + id);
@@ -517,7 +569,7 @@
});
-</script>
+</xscript>
<script>
[4/6] isis git commit: ISIS-1133: styling of tocify,
and downloading its css and js dependencies so can run offline.
Posted by da...@apache.org.
http://git-wip-us.apache.org/repos/asf/isis/blob/b05b63e4/adocs/documentation/src/main/asciidoc/js/jqueryui/1.11.4/jquery-ui.min.js
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/js/jqueryui/1.11.4/jquery-ui.min.js b/adocs/documentation/src/main/asciidoc/js/jqueryui/1.11.4/jquery-ui.min.js
new file mode 100644
index 0000000..5824d12
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/js/jqueryui/1.11.4/jquery-ui.min.js
@@ -0,0 +1,13 @@
+/*! jQuery UI - v1.11.4 - 2015-03-11
+* http://jqueryui.com
+* Includes: core.js, widget.js, mouse.js, position.js, accordion.js, autocomplete.js, button.js, datepicker.js, dialog.js, draggable.js, droppable.js, effect.js, effect-blind.js, effect-bounce.js, effect-clip.js, effect-drop.js, effect-explode.js, effect-fade.js, effect-fold.js, effect-highlight.js, effect-puff.js, effect-pulsate.js, effect-scale.js, effect-shake.js, effect-size.js, effect-slide.js, effect-transfer.js, menu.js, progressbar.js, resizable.js, selectable.js, selectmenu.js, slider.js, sortable.js, spinner.js, tabs.js, tooltip.js
+* Copyright 2015 jQuery Foundation and other contributors; Licensed MIT */
+
+(function(e){"function"==typeof define&&define.amd?define(["jquery"],e):e(jQuery)})(function(e){function t(t,s){var n,a,o,r=t.nodeName.toLowerCase();return"area"===r?(n=t.parentNode,a=n.name,t.href&&a&&"map"===n.nodeName.toLowerCase()?(o=e("img[usemap='#"+a+"']")[0],!!o&&i(o)):!1):(/^(input|select|textarea|button|object)$/.test(r)?!t.disabled:"a"===r?t.href||s:s)&&i(t)}function i(t){return e.expr.filters.visible(t)&&!e(t).parents().addBack().filter(function(){return"hidden"===e.css(this,"visibility")}).length}function s(e){for(var t,i;e.length&&e[0]!==document;){if(t=e.css("position"),("absolute"===t||"relative"===t||"fixed"===t)&&(i=parseInt(e.css("zIndex"),10),!isNaN(i)&&0!==i))return i;e=e.parent()}return 0}function n(){this._curInst=null,this._keyEvent=!1,this._disabledInputs=[],this._datepickerShowing=!1,this._inDialog=!1,this._mainDivId="ui-datepicker-div",this._inlineClass="ui-datepicker-inline",this._appendClass="ui-datepicker-append",this._triggerClass="ui-datepicker-trigge
r",this._dialogClass="ui-datepicker-dialog",this._disableClass="ui-datepicker-disabled",this._unselectableClass="ui-datepicker-unselectable",this._currentClass="ui-datepicker-current-day",this._dayOverClass="ui-datepicker-days-cell-over",this.regional=[],this.regional[""]={closeText:"Done",prevText:"Prev",nextText:"Next",currentText:"Today",monthNames:["January","February","March","April","May","June","July","August","September","October","November","December"],monthNamesShort:["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],dayNames:["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],dayNamesShort:["Sun","Mon","Tue","Wed","Thu","Fri","Sat"],dayNamesMin:["Su","Mo","Tu","We","Th","Fr","Sa"],weekHeader:"Wk",dateFormat:"mm/dd/yy",firstDay:0,isRTL:!1,showMonthAfterYear:!1,yearSuffix:""},this._defaults={showOn:"focus",showAnim:"fadeIn",showOptions:{},defaultDate:null,appendText:"",buttonText:"...",buttonImage:"",buttonImageOnly:!1,hideIfNoPre
vNext:!1,navigationAsDateFormat:!1,gotoCurrent:!1,changeMonth:!1,changeYear:!1,yearRange:"c-10:c+10",showOtherMonths:!1,selectOtherMonths:!1,showWeek:!1,calculateWeek:this.iso8601Week,shortYearCutoff:"+10",minDate:null,maxDate:null,duration:"fast",beforeShowDay:null,beforeShow:null,onSelect:null,onChangeMonthYear:null,onClose:null,numberOfMonths:1,showCurrentAtPos:0,stepMonths:1,stepBigMonths:12,altField:"",altFormat:"",constrainInput:!0,showButtonPanel:!1,autoSize:!1,disabled:!1},e.extend(this._defaults,this.regional[""]),this.regional.en=e.extend(!0,{},this.regional[""]),this.regional["en-US"]=e.extend(!0,{},this.regional.en),this.dpDiv=a(e("<div id='"+this._mainDivId+"' class='ui-datepicker ui-widget ui-widget-content ui-helper-clearfix ui-corner-all'></div>"))}function a(t){var i="button, .ui-datepicker-prev, .ui-datepicker-next, .ui-datepicker-calendar td a";return t.delegate(i,"mouseout",function(){e(this).removeClass("ui-state-hover"),-1!==this.className.indexOf("ui-datepicke
r-prev")&&e(this).removeClass("ui-datepicker-prev-hover"),-1!==this.className.indexOf("ui-datepicker-next")&&e(this).removeClass("ui-datepicker-next-hover")}).delegate(i,"mouseover",o)}function o(){e.datepicker._isDisabledDatepicker(v.inline?v.dpDiv.parent()[0]:v.input[0])||(e(this).parents(".ui-datepicker-calendar").find("a").removeClass("ui-state-hover"),e(this).addClass("ui-state-hover"),-1!==this.className.indexOf("ui-datepicker-prev")&&e(this).addClass("ui-datepicker-prev-hover"),-1!==this.className.indexOf("ui-datepicker-next")&&e(this).addClass("ui-datepicker-next-hover"))}function r(t,i){e.extend(t,i);for(var s in i)null==i[s]&&(t[s]=i[s]);return t}function h(e){return function(){var t=this.element.val();e.apply(this,arguments),this._refresh(),t!==this.element.val()&&this._trigger("change")}}e.ui=e.ui||{},e.extend(e.ui,{version:"1.11.4",keyCode:{BACKSPACE:8,COMMA:188,DELETE:46,DOWN:40,END:35,ENTER:13,ESCAPE:27,HOME:36,LEFT:37,PAGE_DOWN:34,PAGE_UP:33,PERIOD:190,RIGHT:39,SPACE
:32,TAB:9,UP:38}}),e.fn.extend({scrollParent:function(t){var i=this.css("position"),s="absolute"===i,n=t?/(auto|scroll|hidden)/:/(auto|scroll)/,a=this.parents().filter(function(){var t=e(this);return s&&"static"===t.css("position")?!1:n.test(t.css("overflow")+t.css("overflow-y")+t.css("overflow-x"))}).eq(0);return"fixed"!==i&&a.length?a:e(this[0].ownerDocument||document)},uniqueId:function(){var e=0;return function(){return this.each(function(){this.id||(this.id="ui-id-"+ ++e)})}}(),removeUniqueId:function(){return this.each(function(){/^ui-id-\d+$/.test(this.id)&&e(this).removeAttr("id")})}}),e.extend(e.expr[":"],{data:e.expr.createPseudo?e.expr.createPseudo(function(t){return function(i){return!!e.data(i,t)}}):function(t,i,s){return!!e.data(t,s[3])},focusable:function(i){return t(i,!isNaN(e.attr(i,"tabindex")))},tabbable:function(i){var s=e.attr(i,"tabindex"),n=isNaN(s);return(n||s>=0)&&t(i,!n)}}),e("<a>").outerWidth(1).jquery||e.each(["Width","Height"],function(t,i){function s(t,
i,s,a){return e.each(n,function(){i-=parseFloat(e.css(t,"padding"+this))||0,s&&(i-=parseFloat(e.css(t,"border"+this+"Width"))||0),a&&(i-=parseFloat(e.css(t,"margin"+this))||0)}),i}var n="Width"===i?["Left","Right"]:["Top","Bottom"],a=i.toLowerCase(),o={innerWidth:e.fn.innerWidth,innerHeight:e.fn.innerHeight,outerWidth:e.fn.outerWidth,outerHeight:e.fn.outerHeight};e.fn["inner"+i]=function(t){return void 0===t?o["inner"+i].call(this):this.each(function(){e(this).css(a,s(this,t)+"px")})},e.fn["outer"+i]=function(t,n){return"number"!=typeof t?o["outer"+i].call(this,t):this.each(function(){e(this).css(a,s(this,t,!0,n)+"px")})}}),e.fn.addBack||(e.fn.addBack=function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}),e("<a>").data("a-b","a").removeData("a-b").data("a-b")&&(e.fn.removeData=function(t){return function(i){return arguments.length?t.call(this,e.camelCase(i)):t.call(this)}}(e.fn.removeData)),e.ui.ie=!!/msie [\w.]+/.exec(navigator.userAgent.toLowerCase()),e.f
n.extend({focus:function(t){return function(i,s){return"number"==typeof i?this.each(function(){var t=this;setTimeout(function(){e(t).focus(),s&&s.call(t)},i)}):t.apply(this,arguments)}}(e.fn.focus),disableSelection:function(){var e="onselectstart"in document.createElement("div")?"selectstart":"mousedown";return function(){return this.bind(e+".ui-disableSelection",function(e){e.preventDefault()})}}(),enableSelection:function(){return this.unbind(".ui-disableSelection")},zIndex:function(t){if(void 0!==t)return this.css("zIndex",t);if(this.length)for(var i,s,n=e(this[0]);n.length&&n[0]!==document;){if(i=n.css("position"),("absolute"===i||"relative"===i||"fixed"===i)&&(s=parseInt(n.css("zIndex"),10),!isNaN(s)&&0!==s))return s;n=n.parent()}return 0}}),e.ui.plugin={add:function(t,i,s){var n,a=e.ui[t].prototype;for(n in s)a.plugins[n]=a.plugins[n]||[],a.plugins[n].push([i,s[n]])},call:function(e,t,i,s){var n,a=e.plugins[t];if(a&&(s||e.element[0].parentNode&&11!==e.element[0].parentNode.nod
eType))for(n=0;a.length>n;n++)e.options[a[n][0]]&&a[n][1].apply(e.element,i)}};var l=0,u=Array.prototype.slice;e.cleanData=function(t){return function(i){var s,n,a;for(a=0;null!=(n=i[a]);a++)try{s=e._data(n,"events"),s&&s.remove&&e(n).triggerHandler("remove")}catch(o){}t(i)}}(e.cleanData),e.widget=function(t,i,s){var n,a,o,r,h={},l=t.split(".")[0];return t=t.split(".")[1],n=l+"-"+t,s||(s=i,i=e.Widget),e.expr[":"][n.toLowerCase()]=function(t){return!!e.data(t,n)},e[l]=e[l]||{},a=e[l][t],o=e[l][t]=function(e,t){return this._createWidget?(arguments.length&&this._createWidget(e,t),void 0):new o(e,t)},e.extend(o,a,{version:s.version,_proto:e.extend({},s),_childConstructors:[]}),r=new i,r.options=e.widget.extend({},r.options),e.each(s,function(t,s){return e.isFunction(s)?(h[t]=function(){var e=function(){return i.prototype[t].apply(this,arguments)},n=function(e){return i.prototype[t].apply(this,e)};return function(){var t,i=this._super,a=this._superApply;return this._super=e,this._superAp
ply=n,t=s.apply(this,arguments),this._super=i,this._superApply=a,t}}(),void 0):(h[t]=s,void 0)}),o.prototype=e.widget.extend(r,{widgetEventPrefix:a?r.widgetEventPrefix||t:t},h,{constructor:o,namespace:l,widgetName:t,widgetFullName:n}),a?(e.each(a._childConstructors,function(t,i){var s=i.prototype;e.widget(s.namespace+"."+s.widgetName,o,i._proto)}),delete a._childConstructors):i._childConstructors.push(o),e.widget.bridge(t,o),o},e.widget.extend=function(t){for(var i,s,n=u.call(arguments,1),a=0,o=n.length;o>a;a++)for(i in n[a])s=n[a][i],n[a].hasOwnProperty(i)&&void 0!==s&&(t[i]=e.isPlainObject(s)?e.isPlainObject(t[i])?e.widget.extend({},t[i],s):e.widget.extend({},s):s);return t},e.widget.bridge=function(t,i){var s=i.prototype.widgetFullName||t;e.fn[t]=function(n){var a="string"==typeof n,o=u.call(arguments,1),r=this;return a?this.each(function(){var i,a=e.data(this,s);return"instance"===n?(r=a,!1):a?e.isFunction(a[n])&&"_"!==n.charAt(0)?(i=a[n].apply(a,o),i!==a&&void 0!==i?(r=i&&i.jqu
ery?r.pushStack(i.get()):i,!1):void 0):e.error("no such method '"+n+"' for "+t+" widget instance"):e.error("cannot call methods on "+t+" prior to initialization; "+"attempted to call method '"+n+"'")}):(o.length&&(n=e.widget.extend.apply(null,[n].concat(o))),this.each(function(){var t=e.data(this,s);t?(t.option(n||{}),t._init&&t._init()):e.data(this,s,new i(n,this))})),r}},e.Widget=function(){},e.Widget._childConstructors=[],e.Widget.prototype={widgetName:"widget",widgetEventPrefix:"",defaultElement:"<div>",options:{disabled:!1,create:null},_createWidget:function(t,i){i=e(i||this.defaultElement||this)[0],this.element=e(i),this.uuid=l++,this.eventNamespace="."+this.widgetName+this.uuid,this.bindings=e(),this.hoverable=e(),this.focusable=e(),i!==this&&(e.data(i,this.widgetFullName,this),this._on(!0,this.element,{remove:function(e){e.target===i&&this.destroy()}}),this.document=e(i.style?i.ownerDocument:i.document||i),this.window=e(this.document[0].defaultView||this.document[0].parentWi
ndow)),this.options=e.widget.extend({},this.options,this._getCreateOptions(),t),this._create(),this._trigger("create",null,this._getCreateEventData()),this._init()},_getCreateOptions:e.noop,_getCreateEventData:e.noop,_create:e.noop,_init:e.noop,destroy:function(){this._destroy(),this.element.unbind(this.eventNamespace).removeData(this.widgetFullName).removeData(e.camelCase(this.widgetFullName)),this.widget().unbind(this.eventNamespace).removeAttr("aria-disabled").removeClass(this.widgetFullName+"-disabled "+"ui-state-disabled"),this.bindings.unbind(this.eventNamespace),this.hoverable.removeClass("ui-state-hover"),this.focusable.removeClass("ui-state-focus")},_destroy:e.noop,widget:function(){return this.element},option:function(t,i){var s,n,a,o=t;if(0===arguments.length)return e.widget.extend({},this.options);if("string"==typeof t)if(o={},s=t.split("."),t=s.shift(),s.length){for(n=o[t]=e.widget.extend({},this.options[t]),a=0;s.length-1>a;a++)n[s[a]]=n[s[a]]||{},n=n[s[a]];if(t=s.pop(
),1===arguments.length)return void 0===n[t]?null:n[t];n[t]=i}else{if(1===arguments.length)return void 0===this.options[t]?null:this.options[t];o[t]=i}return this._setOptions(o),this},_setOptions:function(e){var t;for(t in e)this._setOption(t,e[t]);return this},_setOption:function(e,t){return this.options[e]=t,"disabled"===e&&(this.widget().toggleClass(this.widgetFullName+"-disabled",!!t),t&&(this.hoverable.removeClass("ui-state-hover"),this.focusable.removeClass("ui-state-focus"))),this},enable:function(){return this._setOptions({disabled:!1})},disable:function(){return this._setOptions({disabled:!0})},_on:function(t,i,s){var n,a=this;"boolean"!=typeof t&&(s=i,i=t,t=!1),s?(i=n=e(i),this.bindings=this.bindings.add(i)):(s=i,i=this.element,n=this.widget()),e.each(s,function(s,o){function r(){return t||a.options.disabled!==!0&&!e(this).hasClass("ui-state-disabled")?("string"==typeof o?a[o]:o).apply(a,arguments):void 0}"string"!=typeof o&&(r.guid=o.guid=o.guid||r.guid||e.guid++);var h=s.
match(/^([\w:-]*)\s*(.*)$/),l=h[1]+a.eventNamespace,u=h[2];u?n.delegate(u,l,r):i.bind(l,r)})},_off:function(t,i){i=(i||"").split(" ").join(this.eventNamespace+" ")+this.eventNamespace,t.unbind(i).undelegate(i),this.bindings=e(this.bindings.not(t).get()),this.focusable=e(this.focusable.not(t).get()),this.hoverable=e(this.hoverable.not(t).get())},_delay:function(e,t){function i(){return("string"==typeof e?s[e]:e).apply(s,arguments)}var s=this;return setTimeout(i,t||0)},_hoverable:function(t){this.hoverable=this.hoverable.add(t),this._on(t,{mouseenter:function(t){e(t.currentTarget).addClass("ui-state-hover")},mouseleave:function(t){e(t.currentTarget).removeClass("ui-state-hover")}})},_focusable:function(t){this.focusable=this.focusable.add(t),this._on(t,{focusin:function(t){e(t.currentTarget).addClass("ui-state-focus")},focusout:function(t){e(t.currentTarget).removeClass("ui-state-focus")}})},_trigger:function(t,i,s){var n,a,o=this.options[t];if(s=s||{},i=e.Event(i),i.type=(t===this.wi
dgetEventPrefix?t:this.widgetEventPrefix+t).toLowerCase(),i.target=this.element[0],a=i.originalEvent)for(n in a)n in i||(i[n]=a[n]);return this.element.trigger(i,s),!(e.isFunction(o)&&o.apply(this.element[0],[i].concat(s))===!1||i.isDefaultPrevented())}},e.each({show:"fadeIn",hide:"fadeOut"},function(t,i){e.Widget.prototype["_"+t]=function(s,n,a){"string"==typeof n&&(n={effect:n});var o,r=n?n===!0||"number"==typeof n?i:n.effect||i:t;n=n||{},"number"==typeof n&&(n={duration:n}),o=!e.isEmptyObject(n),n.complete=a,n.delay&&s.delay(n.delay),o&&e.effects&&e.effects.effect[r]?s[t](n):r!==t&&s[r]?s[r](n.duration,n.easing,a):s.queue(function(i){e(this)[t](),a&&a.call(s[0]),i()})}}),e.widget;var d=!1;e(document).mouseup(function(){d=!1}),e.widget("ui.mouse",{version:"1.11.4",options:{cancel:"input,textarea,button,select,option",distance:1,delay:0},_mouseInit:function(){var t=this;this.element.bind("mousedown."+this.widgetName,function(e){return t._mouseDown(e)}).bind("click."+this.widgetName
,function(i){return!0===e.data(i.target,t.widgetName+".preventClickEvent")?(e.removeData(i.target,t.widgetName+".preventClickEvent"),i.stopImmediatePropagation(),!1):void 0}),this.started=!1},_mouseDestroy:function(){this.element.unbind("."+this.widgetName),this._mouseMoveDelegate&&this.document.unbind("mousemove."+this.widgetName,this._mouseMoveDelegate).unbind("mouseup."+this.widgetName,this._mouseUpDelegate)},_mouseDown:function(t){if(!d){this._mouseMoved=!1,this._mouseStarted&&this._mouseUp(t),this._mouseDownEvent=t;var i=this,s=1===t.which,n="string"==typeof this.options.cancel&&t.target.nodeName?e(t.target).closest(this.options.cancel).length:!1;return s&&!n&&this._mouseCapture(t)?(this.mouseDelayMet=!this.options.delay,this.mouseDelayMet||(this._mouseDelayTimer=setTimeout(function(){i.mouseDelayMet=!0},this.options.delay)),this._mouseDistanceMet(t)&&this._mouseDelayMet(t)&&(this._mouseStarted=this._mouseStart(t)!==!1,!this._mouseStarted)?(t.preventDefault(),!0):(!0===e.data(t
.target,this.widgetName+".preventClickEvent")&&e.removeData(t.target,this.widgetName+".preventClickEvent"),this._mouseMoveDelegate=function(e){return i._mouseMove(e)},this._mouseUpDelegate=function(e){return i._mouseUp(e)},this.document.bind("mousemove."+this.widgetName,this._mouseMoveDelegate).bind("mouseup."+this.widgetName,this._mouseUpDelegate),t.preventDefault(),d=!0,!0)):!0}},_mouseMove:function(t){if(this._mouseMoved){if(e.ui.ie&&(!document.documentMode||9>document.documentMode)&&!t.button)return this._mouseUp(t);if(!t.which)return this._mouseUp(t)}return(t.which||t.button)&&(this._mouseMoved=!0),this._mouseStarted?(this._mouseDrag(t),t.preventDefault()):(this._mouseDistanceMet(t)&&this._mouseDelayMet(t)&&(this._mouseStarted=this._mouseStart(this._mouseDownEvent,t)!==!1,this._mouseStarted?this._mouseDrag(t):this._mouseUp(t)),!this._mouseStarted)},_mouseUp:function(t){return this.document.unbind("mousemove."+this.widgetName,this._mouseMoveDelegate).unbind("mouseup."+this.widge
tName,this._mouseUpDelegate),this._mouseStarted&&(this._mouseStarted=!1,t.target===this._mouseDownEvent.target&&e.data(t.target,this.widgetName+".preventClickEvent",!0),this._mouseStop(t)),d=!1,!1},_mouseDistanceMet:function(e){return Math.max(Math.abs(this._mouseDownEvent.pageX-e.pageX),Math.abs(this._mouseDownEvent.pageY-e.pageY))>=this.options.distance},_mouseDelayMet:function(){return this.mouseDelayMet},_mouseStart:function(){},_mouseDrag:function(){},_mouseStop:function(){},_mouseCapture:function(){return!0}}),function(){function t(e,t,i){return[parseFloat(e[0])*(p.test(e[0])?t/100:1),parseFloat(e[1])*(p.test(e[1])?i/100:1)]}function i(t,i){return parseInt(e.css(t,i),10)||0}function s(t){var i=t[0];return 9===i.nodeType?{width:t.width(),height:t.height(),offset:{top:0,left:0}}:e.isWindow(i)?{width:t.width(),height:t.height(),offset:{top:t.scrollTop(),left:t.scrollLeft()}}:i.preventDefault?{width:0,height:0,offset:{top:i.pageY,left:i.pageX}}:{width:t.outerWidth(),height:t.outer
Height(),offset:t.offset()}}e.ui=e.ui||{};var n,a,o=Math.max,r=Math.abs,h=Math.round,l=/left|center|right/,u=/top|center|bottom/,d=/[\+\-]\d+(\.[\d]+)?%?/,c=/^\w+/,p=/%$/,f=e.fn.position;e.position={scrollbarWidth:function(){if(void 0!==n)return n;var t,i,s=e("<div style='display:block;position:absolute;width:50px;height:50px;overflow:hidden;'><div style='height:100px;width:auto;'></div></div>"),a=s.children()[0];return e("body").append(s),t=a.offsetWidth,s.css("overflow","scroll"),i=a.offsetWidth,t===i&&(i=s[0].clientWidth),s.remove(),n=t-i},getScrollInfo:function(t){var i=t.isWindow||t.isDocument?"":t.element.css("overflow-x"),s=t.isWindow||t.isDocument?"":t.element.css("overflow-y"),n="scroll"===i||"auto"===i&&t.width<t.element[0].scrollWidth,a="scroll"===s||"auto"===s&&t.height<t.element[0].scrollHeight;return{width:a?e.position.scrollbarWidth():0,height:n?e.position.scrollbarWidth():0}},getWithinInfo:function(t){var i=e(t||window),s=e.isWindow(i[0]),n=!!i[0]&&9===i[0].nodeType;
return{element:i,isWindow:s,isDocument:n,offset:i.offset()||{left:0,top:0},scrollLeft:i.scrollLeft(),scrollTop:i.scrollTop(),width:s||n?i.width():i.outerWidth(),height:s||n?i.height():i.outerHeight()}}},e.fn.position=function(n){if(!n||!n.of)return f.apply(this,arguments);n=e.extend({},n);var p,m,g,v,y,b,_=e(n.of),x=e.position.getWithinInfo(n.within),w=e.position.getScrollInfo(x),k=(n.collision||"flip").split(" "),T={};return b=s(_),_[0].preventDefault&&(n.at="left top"),m=b.width,g=b.height,v=b.offset,y=e.extend({},v),e.each(["my","at"],function(){var e,t,i=(n[this]||"").split(" ");1===i.length&&(i=l.test(i[0])?i.concat(["center"]):u.test(i[0])?["center"].concat(i):["center","center"]),i[0]=l.test(i[0])?i[0]:"center",i[1]=u.test(i[1])?i[1]:"center",e=d.exec(i[0]),t=d.exec(i[1]),T[this]=[e?e[0]:0,t?t[0]:0],n[this]=[c.exec(i[0])[0],c.exec(i[1])[0]]}),1===k.length&&(k[1]=k[0]),"right"===n.at[0]?y.left+=m:"center"===n.at[0]&&(y.left+=m/2),"bottom"===n.at[1]?y.top+=g:"center"===n.at[1]&
&(y.top+=g/2),p=t(T.at,m,g),y.left+=p[0],y.top+=p[1],this.each(function(){var s,l,u=e(this),d=u.outerWidth(),c=u.outerHeight(),f=i(this,"marginLeft"),b=i(this,"marginTop"),D=d+f+i(this,"marginRight")+w.width,S=c+b+i(this,"marginBottom")+w.height,M=e.extend({},y),C=t(T.my,u.outerWidth(),u.outerHeight());"right"===n.my[0]?M.left-=d:"center"===n.my[0]&&(M.left-=d/2),"bottom"===n.my[1]?M.top-=c:"center"===n.my[1]&&(M.top-=c/2),M.left+=C[0],M.top+=C[1],a||(M.left=h(M.left),M.top=h(M.top)),s={marginLeft:f,marginTop:b},e.each(["left","top"],function(t,i){e.ui.position[k[t]]&&e.ui.position[k[t]][i](M,{targetWidth:m,targetHeight:g,elemWidth:d,elemHeight:c,collisionPosition:s,collisionWidth:D,collisionHeight:S,offset:[p[0]+C[0],p[1]+C[1]],my:n.my,at:n.at,within:x,elem:u})}),n.using&&(l=function(e){var t=v.left-M.left,i=t+m-d,s=v.top-M.top,a=s+g-c,h={target:{element:_,left:v.left,top:v.top,width:m,height:g},element:{element:u,left:M.left,top:M.top,width:d,height:c},horizontal:0>i?"left":t>0?"r
ight":"center",vertical:0>a?"top":s>0?"bottom":"middle"};d>m&&m>r(t+i)&&(h.horizontal="center"),c>g&&g>r(s+a)&&(h.vertical="middle"),h.important=o(r(t),r(i))>o(r(s),r(a))?"horizontal":"vertical",n.using.call(this,e,h)}),u.offset(e.extend(M,{using:l}))})},e.ui.position={fit:{left:function(e,t){var i,s=t.within,n=s.isWindow?s.scrollLeft:s.offset.left,a=s.width,r=e.left-t.collisionPosition.marginLeft,h=n-r,l=r+t.collisionWidth-a-n;t.collisionWidth>a?h>0&&0>=l?(i=e.left+h+t.collisionWidth-a-n,e.left+=h-i):e.left=l>0&&0>=h?n:h>l?n+a-t.collisionWidth:n:h>0?e.left+=h:l>0?e.left-=l:e.left=o(e.left-r,e.left)},top:function(e,t){var i,s=t.within,n=s.isWindow?s.scrollTop:s.offset.top,a=t.within.height,r=e.top-t.collisionPosition.marginTop,h=n-r,l=r+t.collisionHeight-a-n;t.collisionHeight>a?h>0&&0>=l?(i=e.top+h+t.collisionHeight-a-n,e.top+=h-i):e.top=l>0&&0>=h?n:h>l?n+a-t.collisionHeight:n:h>0?e.top+=h:l>0?e.top-=l:e.top=o(e.top-r,e.top)}},flip:{left:function(e,t){var i,s,n=t.within,a=n.offset.l
eft+n.scrollLeft,o=n.width,h=n.isWindow?n.scrollLeft:n.offset.left,l=e.left-t.collisionPosition.marginLeft,u=l-h,d=l+t.collisionWidth-o-h,c="left"===t.my[0]?-t.elemWidth:"right"===t.my[0]?t.elemWidth:0,p="left"===t.at[0]?t.targetWidth:"right"===t.at[0]?-t.targetWidth:0,f=-2*t.offset[0];0>u?(i=e.left+c+p+f+t.collisionWidth-o-a,(0>i||r(u)>i)&&(e.left+=c+p+f)):d>0&&(s=e.left-t.collisionPosition.marginLeft+c+p+f-h,(s>0||d>r(s))&&(e.left+=c+p+f))},top:function(e,t){var i,s,n=t.within,a=n.offset.top+n.scrollTop,o=n.height,h=n.isWindow?n.scrollTop:n.offset.top,l=e.top-t.collisionPosition.marginTop,u=l-h,d=l+t.collisionHeight-o-h,c="top"===t.my[1],p=c?-t.elemHeight:"bottom"===t.my[1]?t.elemHeight:0,f="top"===t.at[1]?t.targetHeight:"bottom"===t.at[1]?-t.targetHeight:0,m=-2*t.offset[1];0>u?(s=e.top+p+f+m+t.collisionHeight-o-a,(0>s||r(u)>s)&&(e.top+=p+f+m)):d>0&&(i=e.top-t.collisionPosition.marginTop+p+f+m-h,(i>0||d>r(i))&&(e.top+=p+f+m))}},flipfit:{left:function(){e.ui.position.flip.left.appl
y(this,arguments),e.ui.position.fit.left.apply(this,arguments)},top:function(){e.ui.position.flip.top.apply(this,arguments),e.ui.position.fit.top.apply(this,arguments)}}},function(){var t,i,s,n,o,r=document.getElementsByTagName("body")[0],h=document.createElement("div");t=document.createElement(r?"div":"body"),s={visibility:"hidden",width:0,height:0,border:0,margin:0,background:"none"},r&&e.extend(s,{position:"absolute",left:"-1000px",top:"-1000px"});for(o in s)t.style[o]=s[o];t.appendChild(h),i=r||document.documentElement,i.insertBefore(t,i.firstChild),h.style.cssText="position: absolute; left: 10.7432222px;",n=e(h).offset().left,a=n>10&&11>n,t.innerHTML="",i.removeChild(t)}()}(),e.ui.position,e.widget("ui.accordion",{version:"1.11.4",options:{active:0,animate:{},collapsible:!1,event:"click",header:"> li > :first-child,> :not(li):even",heightStyle:"auto",icons:{activeHeader:"ui-icon-triangle-1-s",header:"ui-icon-triangle-1-e"},activate:null,beforeActivate:null},hideProps:{borderTop
Width:"hide",borderBottomWidth:"hide",paddingTop:"hide",paddingBottom:"hide",height:"hide"},showProps:{borderTopWidth:"show",borderBottomWidth:"show",paddingTop:"show",paddingBottom:"show",height:"show"},_create:function(){var t=this.options;this.prevShow=this.prevHide=e(),this.element.addClass("ui-accordion ui-widget ui-helper-reset").attr("role","tablist"),t.collapsible||t.active!==!1&&null!=t.active||(t.active=0),this._processPanels(),0>t.active&&(t.active+=this.headers.length),this._refresh()},_getCreateEventData:function(){return{header:this.active,panel:this.active.length?this.active.next():e()}},_createIcons:function(){var t=this.options.icons;t&&(e("<span>").addClass("ui-accordion-header-icon ui-icon "+t.header).prependTo(this.headers),this.active.children(".ui-accordion-header-icon").removeClass(t.header).addClass(t.activeHeader),this.headers.addClass("ui-accordion-icons"))},_destroyIcons:function(){this.headers.removeClass("ui-accordion-icons").children(".ui-accordion-head
er-icon").remove()},_destroy:function(){var e;this.element.removeClass("ui-accordion ui-widget ui-helper-reset").removeAttr("role"),this.headers.removeClass("ui-accordion-header ui-accordion-header-active ui-state-default ui-corner-all ui-state-active ui-state-disabled ui-corner-top").removeAttr("role").removeAttr("aria-expanded").removeAttr("aria-selected").removeAttr("aria-controls").removeAttr("tabIndex").removeUniqueId(),this._destroyIcons(),e=this.headers.next().removeClass("ui-helper-reset ui-widget-content ui-corner-bottom ui-accordion-content ui-accordion-content-active ui-state-disabled").css("display","").removeAttr("role").removeAttr("aria-hidden").removeAttr("aria-labelledby").removeUniqueId(),"content"!==this.options.heightStyle&&e.css("height","")},_setOption:function(e,t){return"active"===e?(this._activate(t),void 0):("event"===e&&(this.options.event&&this._off(this.headers,this.options.event),this._setupEvents(t)),this._super(e,t),"collapsible"!==e||t||this.options.a
ctive!==!1||this._activate(0),"icons"===e&&(this._destroyIcons(),t&&this._createIcons()),"disabled"===e&&(this.element.toggleClass("ui-state-disabled",!!t).attr("aria-disabled",t),this.headers.add(this.headers.next()).toggleClass("ui-state-disabled",!!t)),void 0)},_keydown:function(t){if(!t.altKey&&!t.ctrlKey){var i=e.ui.keyCode,s=this.headers.length,n=this.headers.index(t.target),a=!1;switch(t.keyCode){case i.RIGHT:case i.DOWN:a=this.headers[(n+1)%s];break;case i.LEFT:case i.UP:a=this.headers[(n-1+s)%s];break;case i.SPACE:case i.ENTER:this._eventHandler(t);break;case i.HOME:a=this.headers[0];break;case i.END:a=this.headers[s-1]}a&&(e(t.target).attr("tabIndex",-1),e(a).attr("tabIndex",0),a.focus(),t.preventDefault())}},_panelKeyDown:function(t){t.keyCode===e.ui.keyCode.UP&&t.ctrlKey&&e(t.currentTarget).prev().focus()},refresh:function(){var t=this.options;this._processPanels(),t.active===!1&&t.collapsible===!0||!this.headers.length?(t.active=!1,this.active=e()):t.active===!1?this._a
ctivate(0):this.active.length&&!e.contains(this.element[0],this.active[0])?this.headers.length===this.headers.find(".ui-state-disabled").length?(t.active=!1,this.active=e()):this._activate(Math.max(0,t.active-1)):t.active=this.headers.index(this.active),this._destroyIcons(),this._refresh()},_processPanels:function(){var e=this.headers,t=this.panels;this.headers=this.element.find(this.options.header).addClass("ui-accordion-header ui-state-default ui-corner-all"),this.panels=this.headers.next().addClass("ui-accordion-content ui-helper-reset ui-widget-content ui-corner-bottom").filter(":not(.ui-accordion-content-active)").hide(),t&&(this._off(e.not(this.headers)),this._off(t.not(this.panels)))},_refresh:function(){var t,i=this.options,s=i.heightStyle,n=this.element.parent();this.active=this._findActive(i.active).addClass("ui-accordion-header-active ui-state-active ui-corner-top").removeClass("ui-corner-all"),this.active.next().addClass("ui-accordion-content-active").show(),this.headers
.attr("role","tab").each(function(){var t=e(this),i=t.uniqueId().attr("id"),s=t.next(),n=s.uniqueId().attr("id");t.attr("aria-controls",n),s.attr("aria-labelledby",i)}).next().attr("role","tabpanel"),this.headers.not(this.active).attr({"aria-selected":"false","aria-expanded":"false",tabIndex:-1}).next().attr({"aria-hidden":"true"}).hide(),this.active.length?this.active.attr({"aria-selected":"true","aria-expanded":"true",tabIndex:0}).next().attr({"aria-hidden":"false"}):this.headers.eq(0).attr("tabIndex",0),this._createIcons(),this._setupEvents(i.event),"fill"===s?(t=n.height(),this.element.siblings(":visible").each(function(){var i=e(this),s=i.css("position");"absolute"!==s&&"fixed"!==s&&(t-=i.outerHeight(!0))}),this.headers.each(function(){t-=e(this).outerHeight(!0)}),this.headers.next().each(function(){e(this).height(Math.max(0,t-e(this).innerHeight()+e(this).height()))}).css("overflow","auto")):"auto"===s&&(t=0,this.headers.next().each(function(){t=Math.max(t,e(this).css("height"
,"").height())}).height(t))},_activate:function(t){var i=this._findActive(t)[0];i!==this.active[0]&&(i=i||this.active[0],this._eventHandler({target:i,currentTarget:i,preventDefault:e.noop}))},_findActive:function(t){return"number"==typeof t?this.headers.eq(t):e()},_setupEvents:function(t){var i={keydown:"_keydown"};t&&e.each(t.split(" "),function(e,t){i[t]="_eventHandler"}),this._off(this.headers.add(this.headers.next())),this._on(this.headers,i),this._on(this.headers.next(),{keydown:"_panelKeyDown"}),this._hoverable(this.headers),this._focusable(this.headers)},_eventHandler:function(t){var i=this.options,s=this.active,n=e(t.currentTarget),a=n[0]===s[0],o=a&&i.collapsible,r=o?e():n.next(),h=s.next(),l={oldHeader:s,oldPanel:h,newHeader:o?e():n,newPanel:r};t.preventDefault(),a&&!i.collapsible||this._trigger("beforeActivate",t,l)===!1||(i.active=o?!1:this.headers.index(n),this.active=a?e():n,this._toggle(l),s.removeClass("ui-accordion-header-active ui-state-active"),i.icons&&s.children
(".ui-accordion-header-icon").removeClass(i.icons.activeHeader).addClass(i.icons.header),a||(n.removeClass("ui-corner-all").addClass("ui-accordion-header-active ui-state-active ui-corner-top"),i.icons&&n.children(".ui-accordion-header-icon").removeClass(i.icons.header).addClass(i.icons.activeHeader),n.next().addClass("ui-accordion-content-active")))},_toggle:function(t){var i=t.newPanel,s=this.prevShow.length?this.prevShow:t.oldPanel;this.prevShow.add(this.prevHide).stop(!0,!0),this.prevShow=i,this.prevHide=s,this.options.animate?this._animate(i,s,t):(s.hide(),i.show(),this._toggleComplete(t)),s.attr({"aria-hidden":"true"}),s.prev().attr({"aria-selected":"false","aria-expanded":"false"}),i.length&&s.length?s.prev().attr({tabIndex:-1,"aria-expanded":"false"}):i.length&&this.headers.filter(function(){return 0===parseInt(e(this).attr("tabIndex"),10)}).attr("tabIndex",-1),i.attr("aria-hidden","false").prev().attr({"aria-selected":"true","aria-expanded":"true",tabIndex:0})},_animate:func
tion(e,t,i){var s,n,a,o=this,r=0,h=e.css("box-sizing"),l=e.length&&(!t.length||e.index()<t.index()),u=this.options.animate||{},d=l&&u.down||u,c=function(){o._toggleComplete(i)};return"number"==typeof d&&(a=d),"string"==typeof d&&(n=d),n=n||d.easing||u.easing,a=a||d.duration||u.duration,t.length?e.length?(s=e.show().outerHeight(),t.animate(this.hideProps,{duration:a,easing:n,step:function(e,t){t.now=Math.round(e)}}),e.hide().animate(this.showProps,{duration:a,easing:n,complete:c,step:function(e,i){i.now=Math.round(e),"height"!==i.prop?"content-box"===h&&(r+=i.now):"content"!==o.options.heightStyle&&(i.now=Math.round(s-t.outerHeight()-r),r=0)}}),void 0):t.animate(this.hideProps,a,n,c):e.animate(this.showProps,a,n,c)},_toggleComplete:function(e){var t=e.oldPanel;t.removeClass("ui-accordion-content-active").prev().removeClass("ui-corner-top").addClass("ui-corner-all"),t.length&&(t.parent()[0].className=t.parent()[0].className),this._trigger("activate",null,e)}}),e.widget("ui.menu",{vers
ion:"1.11.4",defaultElement:"<ul>",delay:300,options:{icons:{submenu:"ui-icon-carat-1-e"},items:"> *",menus:"ul",position:{my:"left-1 top",at:"right top"},role:"menu",blur:null,focus:null,select:null},_create:function(){this.activeMenu=this.element,this.mouseHandled=!1,this.element.uniqueId().addClass("ui-menu ui-widget ui-widget-content").toggleClass("ui-menu-icons",!!this.element.find(".ui-icon").length).attr({role:this.options.role,tabIndex:0}),this.options.disabled&&this.element.addClass("ui-state-disabled").attr("aria-disabled","true"),this._on({"mousedown .ui-menu-item":function(e){e.preventDefault()},"click .ui-menu-item":function(t){var i=e(t.target);!this.mouseHandled&&i.not(".ui-state-disabled").length&&(this.select(t),t.isPropagationStopped()||(this.mouseHandled=!0),i.has(".ui-menu").length?this.expand(t):!this.element.is(":focus")&&e(this.document[0].activeElement).closest(".ui-menu").length&&(this.element.trigger("focus",[!0]),this.active&&1===this.active.parents(".ui-m
enu").length&&clearTimeout(this.timer)))},"mouseenter .ui-menu-item":function(t){if(!this.previousFilter){var i=e(t.currentTarget);
+i.siblings(".ui-state-active").removeClass("ui-state-active"),this.focus(t,i)}},mouseleave:"collapseAll","mouseleave .ui-menu":"collapseAll",focus:function(e,t){var i=this.active||this.element.find(this.options.items).eq(0);t||this.focus(e,i)},blur:function(t){this._delay(function(){e.contains(this.element[0],this.document[0].activeElement)||this.collapseAll(t)})},keydown:"_keydown"}),this.refresh(),this._on(this.document,{click:function(e){this._closeOnDocumentClick(e)&&this.collapseAll(e),this.mouseHandled=!1}})},_destroy:function(){this.element.removeAttr("aria-activedescendant").find(".ui-menu").addBack().removeClass("ui-menu ui-widget ui-widget-content ui-menu-icons ui-front").removeAttr("role").removeAttr("tabIndex").removeAttr("aria-labelledby").removeAttr("aria-expanded").removeAttr("aria-hidden").removeAttr("aria-disabled").removeUniqueId().show(),this.element.find(".ui-menu-item").removeClass("ui-menu-item").removeAttr("role").removeAttr("aria-disabled").removeUniqueId().r
emoveClass("ui-state-hover").removeAttr("tabIndex").removeAttr("role").removeAttr("aria-haspopup").children().each(function(){var t=e(this);t.data("ui-menu-submenu-carat")&&t.remove()}),this.element.find(".ui-menu-divider").removeClass("ui-menu-divider ui-widget-content")},_keydown:function(t){var i,s,n,a,o=!0;switch(t.keyCode){case e.ui.keyCode.PAGE_UP:this.previousPage(t);break;case e.ui.keyCode.PAGE_DOWN:this.nextPage(t);break;case e.ui.keyCode.HOME:this._move("first","first",t);break;case e.ui.keyCode.END:this._move("last","last",t);break;case e.ui.keyCode.UP:this.previous(t);break;case e.ui.keyCode.DOWN:this.next(t);break;case e.ui.keyCode.LEFT:this.collapse(t);break;case e.ui.keyCode.RIGHT:this.active&&!this.active.is(".ui-state-disabled")&&this.expand(t);break;case e.ui.keyCode.ENTER:case e.ui.keyCode.SPACE:this._activate(t);break;case e.ui.keyCode.ESCAPE:this.collapse(t);break;default:o=!1,s=this.previousFilter||"",n=String.fromCharCode(t.keyCode),a=!1,clearTimeout(this.filt
erTimer),n===s?a=!0:n=s+n,i=this._filterMenuItems(n),i=a&&-1!==i.index(this.active.next())?this.active.nextAll(".ui-menu-item"):i,i.length||(n=String.fromCharCode(t.keyCode),i=this._filterMenuItems(n)),i.length?(this.focus(t,i),this.previousFilter=n,this.filterTimer=this._delay(function(){delete this.previousFilter},1e3)):delete this.previousFilter}o&&t.preventDefault()},_activate:function(e){this.active.is(".ui-state-disabled")||(this.active.is("[aria-haspopup='true']")?this.expand(e):this.select(e))},refresh:function(){var t,i,s=this,n=this.options.icons.submenu,a=this.element.find(this.options.menus);this.element.toggleClass("ui-menu-icons",!!this.element.find(".ui-icon").length),a.filter(":not(.ui-menu)").addClass("ui-menu ui-widget ui-widget-content ui-front").hide().attr({role:this.options.role,"aria-hidden":"true","aria-expanded":"false"}).each(function(){var t=e(this),i=t.parent(),s=e("<span>").addClass("ui-menu-icon ui-icon "+n).data("ui-menu-submenu-carat",!0);i.attr("aria
-haspopup","true").prepend(s),t.attr("aria-labelledby",i.attr("id"))}),t=a.add(this.element),i=t.find(this.options.items),i.not(".ui-menu-item").each(function(){var t=e(this);s._isDivider(t)&&t.addClass("ui-widget-content ui-menu-divider")}),i.not(".ui-menu-item, .ui-menu-divider").addClass("ui-menu-item").uniqueId().attr({tabIndex:-1,role:this._itemRole()}),i.filter(".ui-state-disabled").attr("aria-disabled","true"),this.active&&!e.contains(this.element[0],this.active[0])&&this.blur()},_itemRole:function(){return{menu:"menuitem",listbox:"option"}[this.options.role]},_setOption:function(e,t){"icons"===e&&this.element.find(".ui-menu-icon").removeClass(this.options.icons.submenu).addClass(t.submenu),"disabled"===e&&this.element.toggleClass("ui-state-disabled",!!t).attr("aria-disabled",t),this._super(e,t)},focus:function(e,t){var i,s;this.blur(e,e&&"focus"===e.type),this._scrollIntoView(t),this.active=t.first(),s=this.active.addClass("ui-state-focus").removeClass("ui-state-active"),thi
s.options.role&&this.element.attr("aria-activedescendant",s.attr("id")),this.active.parent().closest(".ui-menu-item").addClass("ui-state-active"),e&&"keydown"===e.type?this._close():this.timer=this._delay(function(){this._close()},this.delay),i=t.children(".ui-menu"),i.length&&e&&/^mouse/.test(e.type)&&this._startOpening(i),this.activeMenu=t.parent(),this._trigger("focus",e,{item:t})},_scrollIntoView:function(t){var i,s,n,a,o,r;this._hasScroll()&&(i=parseFloat(e.css(this.activeMenu[0],"borderTopWidth"))||0,s=parseFloat(e.css(this.activeMenu[0],"paddingTop"))||0,n=t.offset().top-this.activeMenu.offset().top-i-s,a=this.activeMenu.scrollTop(),o=this.activeMenu.height(),r=t.outerHeight(),0>n?this.activeMenu.scrollTop(a+n):n+r>o&&this.activeMenu.scrollTop(a+n-o+r))},blur:function(e,t){t||clearTimeout(this.timer),this.active&&(this.active.removeClass("ui-state-focus"),this.active=null,this._trigger("blur",e,{item:this.active}))},_startOpening:function(e){clearTimeout(this.timer),"true"===
e.attr("aria-hidden")&&(this.timer=this._delay(function(){this._close(),this._open(e)},this.delay))},_open:function(t){var i=e.extend({of:this.active},this.options.position);clearTimeout(this.timer),this.element.find(".ui-menu").not(t.parents(".ui-menu")).hide().attr("aria-hidden","true"),t.show().removeAttr("aria-hidden").attr("aria-expanded","true").position(i)},collapseAll:function(t,i){clearTimeout(this.timer),this.timer=this._delay(function(){var s=i?this.element:e(t&&t.target).closest(this.element.find(".ui-menu"));s.length||(s=this.element),this._close(s),this.blur(t),this.activeMenu=s},this.delay)},_close:function(e){e||(e=this.active?this.active.parent():this.element),e.find(".ui-menu").hide().attr("aria-hidden","true").attr("aria-expanded","false").end().find(".ui-state-active").not(".ui-state-focus").removeClass("ui-state-active")},_closeOnDocumentClick:function(t){return!e(t.target).closest(".ui-menu").length},_isDivider:function(e){return!/[^\-\u2014\u2013\s]/.test(e.te
xt())},collapse:function(e){var t=this.active&&this.active.parent().closest(".ui-menu-item",this.element);t&&t.length&&(this._close(),this.focus(e,t))},expand:function(e){var t=this.active&&this.active.children(".ui-menu ").find(this.options.items).first();t&&t.length&&(this._open(t.parent()),this._delay(function(){this.focus(e,t)}))},next:function(e){this._move("next","first",e)},previous:function(e){this._move("prev","last",e)},isFirstItem:function(){return this.active&&!this.active.prevAll(".ui-menu-item").length},isLastItem:function(){return this.active&&!this.active.nextAll(".ui-menu-item").length},_move:function(e,t,i){var s;this.active&&(s="first"===e||"last"===e?this.active["first"===e?"prevAll":"nextAll"](".ui-menu-item").eq(-1):this.active[e+"All"](".ui-menu-item").eq(0)),s&&s.length&&this.active||(s=this.activeMenu.find(this.options.items)[t]()),this.focus(i,s)},nextPage:function(t){var i,s,n;return this.active?(this.isLastItem()||(this._hasScroll()?(s=this.active.offset(
).top,n=this.element.height(),this.active.nextAll(".ui-menu-item").each(function(){return i=e(this),0>i.offset().top-s-n}),this.focus(t,i)):this.focus(t,this.activeMenu.find(this.options.items)[this.active?"last":"first"]())),void 0):(this.next(t),void 0)},previousPage:function(t){var i,s,n;return this.active?(this.isFirstItem()||(this._hasScroll()?(s=this.active.offset().top,n=this.element.height(),this.active.prevAll(".ui-menu-item").each(function(){return i=e(this),i.offset().top-s+n>0}),this.focus(t,i)):this.focus(t,this.activeMenu.find(this.options.items).first())),void 0):(this.next(t),void 0)},_hasScroll:function(){return this.element.outerHeight()<this.element.prop("scrollHeight")},select:function(t){this.active=this.active||e(t.target).closest(".ui-menu-item");var i={item:this.active};this.active.has(".ui-menu").length||this.collapseAll(t,!0),this._trigger("select",t,i)},_filterMenuItems:function(t){var i=t.replace(/[\-\[\]{}()*+?.,\\\^$|#\s]/g,"\\$&"),s=RegExp("^"+i,"i");r
eturn this.activeMenu.find(this.options.items).filter(".ui-menu-item").filter(function(){return s.test(e.trim(e(this).text()))})}}),e.widget("ui.autocomplete",{version:"1.11.4",defaultElement:"<input>",options:{appendTo:null,autoFocus:!1,delay:300,minLength:1,position:{my:"left top",at:"left bottom",collision:"none"},source:null,change:null,close:null,focus:null,open:null,response:null,search:null,select:null},requestIndex:0,pending:0,_create:function(){var t,i,s,n=this.element[0].nodeName.toLowerCase(),a="textarea"===n,o="input"===n;this.isMultiLine=a?!0:o?!1:this.element.prop("isContentEditable"),this.valueMethod=this.element[a||o?"val":"text"],this.isNewMenu=!0,this.element.addClass("ui-autocomplete-input").attr("autocomplete","off"),this._on(this.element,{keydown:function(n){if(this.element.prop("readOnly"))return t=!0,s=!0,i=!0,void 0;t=!1,s=!1,i=!1;var a=e.ui.keyCode;switch(n.keyCode){case a.PAGE_UP:t=!0,this._move("previousPage",n);break;case a.PAGE_DOWN:t=!0,this._move("next
Page",n);break;case a.UP:t=!0,this._keyEvent("previous",n);break;case a.DOWN:t=!0,this._keyEvent("next",n);break;case a.ENTER:this.menu.active&&(t=!0,n.preventDefault(),this.menu.select(n));break;case a.TAB:this.menu.active&&this.menu.select(n);break;case a.ESCAPE:this.menu.element.is(":visible")&&(this.isMultiLine||this._value(this.term),this.close(n),n.preventDefault());break;default:i=!0,this._searchTimeout(n)}},keypress:function(s){if(t)return t=!1,(!this.isMultiLine||this.menu.element.is(":visible"))&&s.preventDefault(),void 0;if(!i){var n=e.ui.keyCode;switch(s.keyCode){case n.PAGE_UP:this._move("previousPage",s);break;case n.PAGE_DOWN:this._move("nextPage",s);break;case n.UP:this._keyEvent("previous",s);break;case n.DOWN:this._keyEvent("next",s)}}},input:function(e){return s?(s=!1,e.preventDefault(),void 0):(this._searchTimeout(e),void 0)},focus:function(){this.selectedItem=null,this.previous=this._value()},blur:function(e){return this.cancelBlur?(delete this.cancelBlur,void 0
):(clearTimeout(this.searching),this.close(e),this._change(e),void 0)}}),this._initSource(),this.menu=e("<ul>").addClass("ui-autocomplete ui-front").appendTo(this._appendTo()).menu({role:null}).hide().menu("instance"),this._on(this.menu.element,{mousedown:function(t){t.preventDefault(),this.cancelBlur=!0,this._delay(function(){delete this.cancelBlur});var i=this.menu.element[0];e(t.target).closest(".ui-menu-item").length||this._delay(function(){var t=this;this.document.one("mousedown",function(s){s.target===t.element[0]||s.target===i||e.contains(i,s.target)||t.close()})})},menufocus:function(t,i){var s,n;return this.isNewMenu&&(this.isNewMenu=!1,t.originalEvent&&/^mouse/.test(t.originalEvent.type))?(this.menu.blur(),this.document.one("mousemove",function(){e(t.target).trigger(t.originalEvent)}),void 0):(n=i.item.data("ui-autocomplete-item"),!1!==this._trigger("focus",t,{item:n})&&t.originalEvent&&/^key/.test(t.originalEvent.type)&&this._value(n.value),s=i.item.attr("aria-label")||n.
value,s&&e.trim(s).length&&(this.liveRegion.children().hide(),e("<div>").text(s).appendTo(this.liveRegion)),void 0)},menuselect:function(e,t){var i=t.item.data("ui-autocomplete-item"),s=this.previous;this.element[0]!==this.document[0].activeElement&&(this.element.focus(),this.previous=s,this._delay(function(){this.previous=s,this.selectedItem=i})),!1!==this._trigger("select",e,{item:i})&&this._value(i.value),this.term=this._value(),this.close(e),this.selectedItem=i}}),this.liveRegion=e("<span>",{role:"status","aria-live":"assertive","aria-relevant":"additions"}).addClass("ui-helper-hidden-accessible").appendTo(this.document[0].body),this._on(this.window,{beforeunload:function(){this.element.removeAttr("autocomplete")}})},_destroy:function(){clearTimeout(this.searching),this.element.removeClass("ui-autocomplete-input").removeAttr("autocomplete"),this.menu.element.remove(),this.liveRegion.remove()},_setOption:function(e,t){this._super(e,t),"source"===e&&this._initSource(),"appendTo"==
=e&&this.menu.element.appendTo(this._appendTo()),"disabled"===e&&t&&this.xhr&&this.xhr.abort()},_appendTo:function(){var t=this.options.appendTo;return t&&(t=t.jquery||t.nodeType?e(t):this.document.find(t).eq(0)),t&&t[0]||(t=this.element.closest(".ui-front")),t.length||(t=this.document[0].body),t},_initSource:function(){var t,i,s=this;e.isArray(this.options.source)?(t=this.options.source,this.source=function(i,s){s(e.ui.autocomplete.filter(t,i.term))}):"string"==typeof this.options.source?(i=this.options.source,this.source=function(t,n){s.xhr&&s.xhr.abort(),s.xhr=e.ajax({url:i,data:t,dataType:"json",success:function(e){n(e)},error:function(){n([])}})}):this.source=this.options.source},_searchTimeout:function(e){clearTimeout(this.searching),this.searching=this._delay(function(){var t=this.term===this._value(),i=this.menu.element.is(":visible"),s=e.altKey||e.ctrlKey||e.metaKey||e.shiftKey;(!t||t&&!i&&!s)&&(this.selectedItem=null,this.search(null,e))},this.options.delay)},search:functi
on(e,t){return e=null!=e?e:this._value(),this.term=this._value(),e.length<this.options.minLength?this.close(t):this._trigger("search",t)!==!1?this._search(e):void 0},_search:function(e){this.pending++,this.element.addClass("ui-autocomplete-loading"),this.cancelSearch=!1,this.source({term:e},this._response())},_response:function(){var t=++this.requestIndex;return e.proxy(function(e){t===this.requestIndex&&this.__response(e),this.pending--,this.pending||this.element.removeClass("ui-autocomplete-loading")},this)},__response:function(e){e&&(e=this._normalize(e)),this._trigger("response",null,{content:e}),!this.options.disabled&&e&&e.length&&!this.cancelSearch?(this._suggest(e),this._trigger("open")):this._close()},close:function(e){this.cancelSearch=!0,this._close(e)},_close:function(e){this.menu.element.is(":visible")&&(this.menu.element.hide(),this.menu.blur(),this.isNewMenu=!0,this._trigger("close",e))},_change:function(e){this.previous!==this._value()&&this._trigger("change",e,{item
:this.selectedItem})},_normalize:function(t){return t.length&&t[0].label&&t[0].value?t:e.map(t,function(t){return"string"==typeof t?{label:t,value:t}:e.extend({},t,{label:t.label||t.value,value:t.value||t.label})})},_suggest:function(t){var i=this.menu.element.empty();this._renderMenu(i,t),this.isNewMenu=!0,this.menu.refresh(),i.show(),this._resizeMenu(),i.position(e.extend({of:this.element},this.options.position)),this.options.autoFocus&&this.menu.next()},_resizeMenu:function(){var e=this.menu.element;e.outerWidth(Math.max(e.width("").outerWidth()+1,this.element.outerWidth()))},_renderMenu:function(t,i){var s=this;e.each(i,function(e,i){s._renderItemData(t,i)})},_renderItemData:function(e,t){return this._renderItem(e,t).data("ui-autocomplete-item",t)},_renderItem:function(t,i){return e("<li>").text(i.label).appendTo(t)},_move:function(e,t){return this.menu.element.is(":visible")?this.menu.isFirstItem()&&/^previous/.test(e)||this.menu.isLastItem()&&/^next/.test(e)?(this.isMultiLine|
|this._value(this.term),this.menu.blur(),void 0):(this.menu[e](t),void 0):(this.search(null,t),void 0)},widget:function(){return this.menu.element},_value:function(){return this.valueMethod.apply(this.element,arguments)},_keyEvent:function(e,t){(!this.isMultiLine||this.menu.element.is(":visible"))&&(this._move(e,t),t.preventDefault())}}),e.extend(e.ui.autocomplete,{escapeRegex:function(e){return e.replace(/[\-\[\]{}()*+?.,\\\^$|#\s]/g,"\\$&")},filter:function(t,i){var s=RegExp(e.ui.autocomplete.escapeRegex(i),"i");return e.grep(t,function(e){return s.test(e.label||e.value||e)})}}),e.widget("ui.autocomplete",e.ui.autocomplete,{options:{messages:{noResults:"No search results.",results:function(e){return e+(e>1?" results are":" result is")+" available, use up and down arrow keys to navigate."}}},__response:function(t){var i;this._superApply(arguments),this.options.disabled||this.cancelSearch||(i=t&&t.length?this.options.messages.results(t.length):this.options.messages.noResults,this.li
veRegion.children().hide(),e("<div>").text(i).appendTo(this.liveRegion))}}),e.ui.autocomplete;var c,p="ui-button ui-widget ui-state-default ui-corner-all",f="ui-button-icons-only ui-button-icon-only ui-button-text-icons ui-button-text-icon-primary ui-button-text-icon-secondary ui-button-text-only",m=function(){var t=e(this);setTimeout(function(){t.find(":ui-button").button("refresh")},1)},g=function(t){var i=t.name,s=t.form,n=e([]);return i&&(i=i.replace(/'/g,"\\'"),n=s?e(s).find("[name='"+i+"'][type=radio]"):e("[name='"+i+"'][type=radio]",t.ownerDocument).filter(function(){return!this.form})),n};e.widget("ui.button",{version:"1.11.4",defaultElement:"<button>",options:{disabled:null,text:!0,label:null,icons:{primary:null,secondary:null}},_create:function(){this.element.closest("form").unbind("reset"+this.eventNamespace).bind("reset"+this.eventNamespace,m),"boolean"!=typeof this.options.disabled?this.options.disabled=!!this.element.prop("disabled"):this.element.prop("disabled",this.o
ptions.disabled),this._determineButtonType(),this.hasTitle=!!this.buttonElement.attr("title");var t=this,i=this.options,s="checkbox"===this.type||"radio"===this.type,n=s?"":"ui-state-active";null===i.label&&(i.label="input"===this.type?this.buttonElement.val():this.buttonElement.html()),this._hoverable(this.buttonElement),this.buttonElement.addClass(p).attr("role","button").bind("mouseenter"+this.eventNamespace,function(){i.disabled||this===c&&e(this).addClass("ui-state-active")}).bind("mouseleave"+this.eventNamespace,function(){i.disabled||e(this).removeClass(n)}).bind("click"+this.eventNamespace,function(e){i.disabled&&(e.preventDefault(),e.stopImmediatePropagation())}),this._on({focus:function(){this.buttonElement.addClass("ui-state-focus")},blur:function(){this.buttonElement.removeClass("ui-state-focus")}}),s&&this.element.bind("change"+this.eventNamespace,function(){t.refresh()}),"checkbox"===this.type?this.buttonElement.bind("click"+this.eventNamespace,function(){return i.disa
bled?!1:void 0}):"radio"===this.type?this.buttonElement.bind("click"+this.eventNamespace,function(){if(i.disabled)return!1;e(this).addClass("ui-state-active"),t.buttonElement.attr("aria-pressed","true");var s=t.element[0];g(s).not(s).map(function(){return e(this).button("widget")[0]}).removeClass("ui-state-active").attr("aria-pressed","false")}):(this.buttonElement.bind("mousedown"+this.eventNamespace,function(){return i.disabled?!1:(e(this).addClass("ui-state-active"),c=this,t.document.one("mouseup",function(){c=null}),void 0)}).bind("mouseup"+this.eventNamespace,function(){return i.disabled?!1:(e(this).removeClass("ui-state-active"),void 0)}).bind("keydown"+this.eventNamespace,function(t){return i.disabled?!1:((t.keyCode===e.ui.keyCode.SPACE||t.keyCode===e.ui.keyCode.ENTER)&&e(this).addClass("ui-state-active"),void 0)}).bind("keyup"+this.eventNamespace+" blur"+this.eventNamespace,function(){e(this).removeClass("ui-state-active")}),this.buttonElement.is("a")&&this.buttonElement.key
up(function(t){t.keyCode===e.ui.keyCode.SPACE&&e(this).click()})),this._setOption("disabled",i.disabled),this._resetButton()},_determineButtonType:function(){var e,t,i;this.type=this.element.is("[type=checkbox]")?"checkbox":this.element.is("[type=radio]")?"radio":this.element.is("input")?"input":"button","checkbox"===this.type||"radio"===this.type?(e=this.element.parents().last(),t="label[for='"+this.element.attr("id")+"']",this.buttonElement=e.find(t),this.buttonElement.length||(e=e.length?e.siblings():this.element.siblings(),this.buttonElement=e.filter(t),this.buttonElement.length||(this.buttonElement=e.find(t))),this.element.addClass("ui-helper-hidden-accessible"),i=this.element.is(":checked"),i&&this.buttonElement.addClass("ui-state-active"),this.buttonElement.prop("aria-pressed",i)):this.buttonElement=this.element},widget:function(){return this.buttonElement},_destroy:function(){this.element.removeClass("ui-helper-hidden-accessible"),this.buttonElement.removeClass(p+" ui-state-
active "+f).removeAttr("role").removeAttr("aria-pressed").html(this.buttonElement.find(".ui-button-text").html()),this.hasTitle||this.buttonElement.removeAttr("title")},_setOption:function(e,t){return this._super(e,t),"disabled"===e?(this.widget().toggleClass("ui-state-disabled",!!t),this.element.prop("disabled",!!t),t&&("checkbox"===this.type||"radio"===this.type?this.buttonElement.removeClass("ui-state-focus"):this.buttonElement.removeClass("ui-state-focus ui-state-active")),void 0):(this._resetButton(),void 0)},refresh:function(){var t=this.element.is("input, button")?this.element.is(":disabled"):this.element.hasClass("ui-button-disabled");t!==this.options.disabled&&this._setOption("disabled",t),"radio"===this.type?g(this.element[0]).each(function(){e(this).is(":checked")?e(this).button("widget").addClass("ui-state-active").attr("aria-pressed","true"):e(this).button("widget").removeClass("ui-state-active").attr("aria-pressed","false")}):"checkbox"===this.type&&(this.element.is(":
checked")?this.buttonElement.addClass("ui-state-active").attr("aria-pressed","true"):this.buttonElement.removeClass("ui-state-active").attr("aria-pressed","false"))},_resetButton:function(){if("input"===this.type)return this.options.label&&this.element.val(this.options.label),void 0;var t=this.buttonElement.removeClass(f),i=e("<span></span>",this.document[0]).addClass("ui-button-text").html(this.options.label).appendTo(t.empty()).text(),s=this.options.icons,n=s.primary&&s.secondary,a=[];s.primary||s.secondary?(this.options.text&&a.push("ui-button-text-icon"+(n?"s":s.primary?"-primary":"-secondary")),s.primary&&t.prepend("<span class='ui-button-icon-primary ui-icon "+s.primary+"'></span>"),s.secondary&&t.append("<span class='ui-button-icon-secondary ui-icon "+s.secondary+"'></span>"),this.options.text||(a.push(n?"ui-button-icons-only":"ui-button-icon-only"),this.hasTitle||t.attr("title",e.trim(i)))):a.push("ui-button-text-only"),t.addClass(a.join(" "))}}),e.widget("ui.buttonset",{ver
sion:"1.11.4",options:{items:"button, input[type=button], input[type=submit], input[type=reset], input[type=checkbox], input[type=radio], a, :data(ui-button)"},_create:function(){this.element.addClass("ui-buttonset")},_init:function(){this.refresh()},_setOption:function(e,t){"disabled"===e&&this.buttons.button("option",e,t),this._super(e,t)},refresh:function(){var t="rtl"===this.element.css("direction"),i=this.element.find(this.options.items),s=i.filter(":ui-button");i.not(":ui-button").button(),s.button("refresh"),this.buttons=i.map(function(){return e(this).button("widget")[0]}).removeClass("ui-corner-all ui-corner-left ui-corner-right").filter(":first").addClass(t?"ui-corner-right":"ui-corner-left").end().filter(":last").addClass(t?"ui-corner-left":"ui-corner-right").end().end()},_destroy:function(){this.element.removeClass("ui-buttonset"),this.buttons.map(function(){return e(this).button("widget")[0]}).removeClass("ui-corner-left ui-corner-right").end().button("destroy")}}),e.ui
.button,e.extend(e.ui,{datepicker:{version:"1.11.4"}});var v;e.extend(n.prototype,{markerClassName:"hasDatepicker",maxRows:4,_widgetDatepicker:function(){return this.dpDiv},setDefaults:function(e){return r(this._defaults,e||{}),this},_attachDatepicker:function(t,i){var s,n,a;s=t.nodeName.toLowerCase(),n="div"===s||"span"===s,t.id||(this.uuid+=1,t.id="dp"+this.uuid),a=this._newInst(e(t),n),a.settings=e.extend({},i||{}),"input"===s?this._connectDatepicker(t,a):n&&this._inlineDatepicker(t,a)},_newInst:function(t,i){var s=t[0].id.replace(/([^A-Za-z0-9_\-])/g,"\\\\$1");return{id:s,input:t,selectedDay:0,selectedMonth:0,selectedYear:0,drawMonth:0,drawYear:0,inline:i,dpDiv:i?a(e("<div class='"+this._inlineClass+" ui-datepicker ui-widget ui-widget-content ui-helper-clearfix ui-corner-all'></div>")):this.dpDiv}},_connectDatepicker:function(t,i){var s=e(t);i.append=e([]),i.trigger=e([]),s.hasClass(this.markerClassName)||(this._attachments(s,i),s.addClass(this.markerClassName).keydown(this._doK
eyDown).keypress(this._doKeyPress).keyup(this._doKeyUp),this._autoSize(i),e.data(t,"datepicker",i),i.settings.disabled&&this._disableDatepicker(t))},_attachments:function(t,i){var s,n,a,o=this._get(i,"appendText"),r=this._get(i,"isRTL");i.append&&i.append.remove(),o&&(i.append=e("<span class='"+this._appendClass+"'>"+o+"</span>"),t[r?"before":"after"](i.append)),t.unbind("focus",this._showDatepicker),i.trigger&&i.trigger.remove(),s=this._get(i,"showOn"),("focus"===s||"both"===s)&&t.focus(this._showDatepicker),("button"===s||"both"===s)&&(n=this._get(i,"buttonText"),a=this._get(i,"buttonImage"),i.trigger=e(this._get(i,"buttonImageOnly")?e("<img/>").addClass(this._triggerClass).attr({src:a,alt:n,title:n}):e("<button type='button'></button>").addClass(this._triggerClass).html(a?e("<img/>").attr({src:a,alt:n,title:n}):n)),t[r?"before":"after"](i.trigger),i.trigger.click(function(){return e.datepicker._datepickerShowing&&e.datepicker._lastInput===t[0]?e.datepicker._hideDatepicker():e.dat
epicker._datepickerShowing&&e.datepicker._lastInput!==t[0]?(e.datepicker._hideDatepicker(),e.datepicker._showDatepicker(t[0])):e.datepicker._showDatepicker(t[0]),!1}))},_autoSize:function(e){if(this._get(e,"autoSize")&&!e.inline){var t,i,s,n,a=new Date(2009,11,20),o=this._get(e,"dateFormat");o.match(/[DM]/)&&(t=function(e){for(i=0,s=0,n=0;e.length>n;n++)e[n].length>i&&(i=e[n].length,s=n);return s},a.setMonth(t(this._get(e,o.match(/MM/)?"monthNames":"monthNamesShort"))),a.setDate(t(this._get(e,o.match(/DD/)?"dayNames":"dayNamesShort"))+20-a.getDay())),e.input.attr("size",this._formatDate(e,a).length)}},_inlineDatepicker:function(t,i){var s=e(t);s.hasClass(this.markerClassName)||(s.addClass(this.markerClassName).append(i.dpDiv),e.data(t,"datepicker",i),this._setDate(i,this._getDefaultDate(i),!0),this._updateDatepicker(i),this._updateAlternate(i),i.settings.disabled&&this._disableDatepicker(t),i.dpDiv.css("display","block"))},_dialogDatepicker:function(t,i,s,n,a){var o,h,l,u,d,c=this._
dialogInst;return c||(this.uuid+=1,o="dp"+this.uuid,this._dialogInput=e("<input type='text' id='"+o+"' style='position: absolute; top: -100px; width: 0px;'/>"),this._dialogInput.keydown(this._doKeyDown),e("body").append(this._dialogInput),c=this._dialogInst=this._newInst(this._dialogInput,!1),c.settings={},e.data(this._dialogInput[0],"datepicker",c)),r(c.settings,n||{}),i=i&&i.constructor===Date?this._formatDate(c,i):i,this._dialogInput.val(i),this._pos=a?a.length?a:[a.pageX,a.pageY]:null,this._pos||(h=document.documentElement.clientWidth,l=document.documentElement.clientHeight,u=document.documentElement.scrollLeft||document.body.scrollLeft,d=document.documentElement.scrollTop||document.body.scrollTop,this._pos=[h/2-100+u,l/2-150+d]),this._dialogInput.css("left",this._pos[0]+20+"px").css("top",this._pos[1]+"px"),c.settings.onSelect=s,this._inDialog=!0,this.dpDiv.addClass(this._dialogClass),this._showDatepicker(this._dialogInput[0]),e.blockUI&&e.blockUI(this.dpDiv),e.data(this._dialo
gInput[0],"datepicker",c),this},_destroyDatepicker:function(t){var i,s=e(t),n=e.data(t,"datepicker");s.hasClass(this.markerClassName)&&(i=t.nodeName.toLowerCase(),e.removeData(t,"datepicker"),"input"===i?(n.append.remove(),n.trigger.remove(),s.removeClass(this.markerClassName).unbind("focus",this._showDatepicker).unbind("keydown",this._doKeyDown).unbind("keypress",this._doKeyPress).unbind("keyup",this._doKeyUp)):("div"===i||"span"===i)&&s.removeClass(this.markerClassName).empty(),v===n&&(v=null))},_enableDatepicker:function(t){var i,s,n=e(t),a=e.data(t,"datepicker");n.hasClass(this.markerClassName)&&(i=t.nodeName.toLowerCase(),"input"===i?(t.disabled=!1,a.trigger.filter("button").each(function(){this.disabled=!1}).end().filter("img").css({opacity:"1.0",cursor:""})):("div"===i||"span"===i)&&(s=n.children("."+this._inlineClass),s.children().removeClass("ui-state-disabled"),s.find("select.ui-datepicker-month, select.ui-datepicker-year").prop("disabled",!1)),this._disabledInputs=e.map(t
his._disabledInputs,function(e){return e===t?null:e}))},_disableDatepicker:function(t){var i,s,n=e(t),a=e.data(t,"datepicker");n.hasClass(this.markerClassName)&&(i=t.nodeName.toLowerCase(),"input"===i?(t.disabled=!0,a.trigger.filter("button").each(function(){this.disabled=!0}).end().filter("img").css({opacity:"0.5",cursor:"default"})):("div"===i||"span"===i)&&(s=n.children("."+this._inlineClass),s.children().addClass("ui-state-disabled"),s.find("select.ui-datepicker-month, select.ui-datepicker-year").prop("disabled",!0)),this._disabledInputs=e.map(this._disabledInputs,function(e){return e===t?null:e}),this._disabledInputs[this._disabledInputs.length]=t)},_isDisabledDatepicker:function(e){if(!e)return!1;for(var t=0;this._disabledInputs.length>t;t++)if(this._disabledInputs[t]===e)return!0;return!1},_getInst:function(t){try{return e.data(t,"datepicker")}catch(i){throw"Missing instance data for this datepicker"}},_optionDatepicker:function(t,i,s){var n,a,o,h,l=this._getInst(t);return 2=
==arguments.length&&"string"==typeof i?"defaults"===i?e.extend({},e.datepicker._defaults):l?"all"===i?e.extend({},l.settings):this._get(l,i):null:(n=i||{},"string"==typeof i&&(n={},n[i]=s),l&&(this._curInst===l&&this._hideDatepicker(),a=this._getDateDatepicker(t,!0),o=this._getMinMaxDate(l,"min"),h=this._getMinMaxDate(l,"max"),r(l.settings,n),null!==o&&void 0!==n.dateFormat&&void 0===n.minDate&&(l.settings.minDate=this._formatDate(l,o)),null!==h&&void 0!==n.dateFormat&&void 0===n.maxDate&&(l.settings.maxDate=this._formatDate(l,h)),"disabled"in n&&(n.disabled?this._disableDatepicker(t):this._enableDatepicker(t)),this._attachments(e(t),l),this._autoSize(l),this._setDate(l,a),this._updateAlternate(l),this._updateDatepicker(l)),void 0)},_changeDatepicker:function(e,t,i){this._optionDatepicker(e,t,i)},_refreshDatepicker:function(e){var t=this._getInst(e);t&&this._updateDatepicker(t)},_setDateDatepicker:function(e,t){var i=this._getInst(e);i&&(this._setDate(i,t),this._updateDatepicker(i),
this._updateAlternate(i))},_getDateDatepicker:function(e,t){var i=this._getInst(e);return i&&!i.inline&&this._setDateFromField(i,t),i?this._getDate(i):null},_doKeyDown:function(t){var i,s,n,a=e.datepicker._getInst(t.target),o=!0,r=a.dpDiv.is(".ui-datepicker-rtl");if(a._keyEvent=!0,e.datepicker._datepickerShowing)switch(t.keyCode){case 9:e.datepicker._hideDatepicker(),o=!1;break;case 13:return n=e("td."+e.datepicker._dayOverClass+":not(."+e.datepicker._currentClass+")",a.dpDiv),n[0]&&e.datepicker._selectDay(t.target,a.selectedMonth,a.selectedYear,n[0]),i=e.datepicker._get(a,"onSelect"),i?(s=e.datepicker._formatDate(a),i.apply(a.input?a.input[0]:null,[s,a])):e.datepicker._hideDatepicker(),!1;case 27:e.datepicker._hideDatepicker();break;case 33:e.datepicker._adjustDate(t.target,t.ctrlKey?-e.datepicker._get(a,"stepBigMonths"):-e.datepicker._get(a,"stepMonths"),"M");break;case 34:e.datepicker._adjustDate(t.target,t.ctrlKey?+e.datepicker._get(a,"stepBigMonths"):+e.datepicker._get(a,"stepM
onths"),"M");break;case 35:(t.ctrlKey||t.metaKey)&&e.datepicker._clearDate(t.target),o=t.ctrlKey||t.metaKey;break;case 36:(t.ctrlKey||t.metaKey)&&e.datepicker._gotoToday(t.target),o=t.ctrlKey||t.metaKey;break;case 37:(t.ctrlKey||t.metaKey)&&e.datepicker._adjustDate(t.target,r?1:-1,"D"),o=t.ctrlKey||t.metaKey,t.originalEvent.altKey&&e.datepicker._adjustDate(t.target,t.ctrlKey?-e.datepicker._get(a,"stepBigMonths"):-e.datepicker._get(a,"stepMonths"),"M");break;case 38:(t.ctrlKey||t.metaKey)&&e.datepicker._adjustDate(t.target,-7,"D"),o=t.ctrlKey||t.metaKey;break;case 39:(t.ctrlKey||t.metaKey)&&e.datepicker._adjustDate(t.target,r?-1:1,"D"),o=t.ctrlKey||t.metaKey,t.originalEvent.altKey&&e.datepicker._adjustDate(t.target,t.ctrlKey?+e.datepicker._get(a,"stepBigMonths"):+e.datepicker._get(a,"stepMonths"),"M");break;case 40:(t.ctrlKey||t.metaKey)&&e.datepicker._adjustDate(t.target,7,"D"),o=t.ctrlKey||t.metaKey;break;default:o=!1}else 36===t.keyCode&&t.ctrlKey?e.datepicker._showDatepicker(this
):o=!1;o&&(t.preventDefault(),t.stopPropagation())},_doKeyPress:function(t){var i,s,n=e.datepicker._getInst(t.target);
+return e.datepicker._get(n,"constrainInput")?(i=e.datepicker._possibleChars(e.datepicker._get(n,"dateFormat")),s=String.fromCharCode(null==t.charCode?t.keyCode:t.charCode),t.ctrlKey||t.metaKey||" ">s||!i||i.indexOf(s)>-1):void 0},_doKeyUp:function(t){var i,s=e.datepicker._getInst(t.target);if(s.input.val()!==s.lastVal)try{i=e.datepicker.parseDate(e.datepicker._get(s,"dateFormat"),s.input?s.input.val():null,e.datepicker._getFormatConfig(s)),i&&(e.datepicker._setDateFromField(s),e.datepicker._updateAlternate(s),e.datepicker._updateDatepicker(s))}catch(n){}return!0},_showDatepicker:function(t){if(t=t.target||t,"input"!==t.nodeName.toLowerCase()&&(t=e("input",t.parentNode)[0]),!e.datepicker._isDisabledDatepicker(t)&&e.datepicker._lastInput!==t){var i,n,a,o,h,l,u;i=e.datepicker._getInst(t),e.datepicker._curInst&&e.datepicker._curInst!==i&&(e.datepicker._curInst.dpDiv.stop(!0,!0),i&&e.datepicker._datepickerShowing&&e.datepicker._hideDatepicker(e.datepicker._curInst.input[0])),n=e.datepick
er._get(i,"beforeShow"),a=n?n.apply(t,[t,i]):{},a!==!1&&(r(i.settings,a),i.lastVal=null,e.datepicker._lastInput=t,e.datepicker._setDateFromField(i),e.datepicker._inDialog&&(t.value=""),e.datepicker._pos||(e.datepicker._pos=e.datepicker._findPos(t),e.datepicker._pos[1]+=t.offsetHeight),o=!1,e(t).parents().each(function(){return o|="fixed"===e(this).css("position"),!o}),h={left:e.datepicker._pos[0],top:e.datepicker._pos[1]},e.datepicker._pos=null,i.dpDiv.empty(),i.dpDiv.css({position:"absolute",display:"block",top:"-1000px"}),e.datepicker._updateDatepicker(i),h=e.datepicker._checkOffset(i,h,o),i.dpDiv.css({position:e.datepicker._inDialog&&e.blockUI?"static":o?"fixed":"absolute",display:"none",left:h.left+"px",top:h.top+"px"}),i.inline||(l=e.datepicker._get(i,"showAnim"),u=e.datepicker._get(i,"duration"),i.dpDiv.css("z-index",s(e(t))+1),e.datepicker._datepickerShowing=!0,e.effects&&e.effects.effect[l]?i.dpDiv.show(l,e.datepicker._get(i,"showOptions"),u):i.dpDiv[l||"show"](l?u:null),e.d
atepicker._shouldFocusInput(i)&&i.input.focus(),e.datepicker._curInst=i))}},_updateDatepicker:function(t){this.maxRows=4,v=t,t.dpDiv.empty().append(this._generateHTML(t)),this._attachHandlers(t);var i,s=this._getNumberOfMonths(t),n=s[1],a=17,r=t.dpDiv.find("."+this._dayOverClass+" a");r.length>0&&o.apply(r.get(0)),t.dpDiv.removeClass("ui-datepicker-multi-2 ui-datepicker-multi-3 ui-datepicker-multi-4").width(""),n>1&&t.dpDiv.addClass("ui-datepicker-multi-"+n).css("width",a*n+"em"),t.dpDiv[(1!==s[0]||1!==s[1]?"add":"remove")+"Class"]("ui-datepicker-multi"),t.dpDiv[(this._get(t,"isRTL")?"add":"remove")+"Class"]("ui-datepicker-rtl"),t===e.datepicker._curInst&&e.datepicker._datepickerShowing&&e.datepicker._shouldFocusInput(t)&&t.input.focus(),t.yearshtml&&(i=t.yearshtml,setTimeout(function(){i===t.yearshtml&&t.yearshtml&&t.dpDiv.find("select.ui-datepicker-year:first").replaceWith(t.yearshtml),i=t.yearshtml=null},0))},_shouldFocusInput:function(e){return e.input&&e.input.is(":visible")&&!
e.input.is(":disabled")&&!e.input.is(":focus")},_checkOffset:function(t,i,s){var n=t.dpDiv.outerWidth(),a=t.dpDiv.outerHeight(),o=t.input?t.input.outerWidth():0,r=t.input?t.input.outerHeight():0,h=document.documentElement.clientWidth+(s?0:e(document).scrollLeft()),l=document.documentElement.clientHeight+(s?0:e(document).scrollTop());return i.left-=this._get(t,"isRTL")?n-o:0,i.left-=s&&i.left===t.input.offset().left?e(document).scrollLeft():0,i.top-=s&&i.top===t.input.offset().top+r?e(document).scrollTop():0,i.left-=Math.min(i.left,i.left+n>h&&h>n?Math.abs(i.left+n-h):0),i.top-=Math.min(i.top,i.top+a>l&&l>a?Math.abs(a+r):0),i},_findPos:function(t){for(var i,s=this._getInst(t),n=this._get(s,"isRTL");t&&("hidden"===t.type||1!==t.nodeType||e.expr.filters.hidden(t));)t=t[n?"previousSibling":"nextSibling"];return i=e(t).offset(),[i.left,i.top]},_hideDatepicker:function(t){var i,s,n,a,o=this._curInst;!o||t&&o!==e.data(t,"datepicker")||this._datepickerShowing&&(i=this._get(o,"showAnim"),s=t
his._get(o,"duration"),n=function(){e.datepicker._tidyDialog(o)},e.effects&&(e.effects.effect[i]||e.effects[i])?o.dpDiv.hide(i,e.datepicker._get(o,"showOptions"),s,n):o.dpDiv["slideDown"===i?"slideUp":"fadeIn"===i?"fadeOut":"hide"](i?s:null,n),i||n(),this._datepickerShowing=!1,a=this._get(o,"onClose"),a&&a.apply(o.input?o.input[0]:null,[o.input?o.input.val():"",o]),this._lastInput=null,this._inDialog&&(this._dialogInput.css({position:"absolute",left:"0",top:"-100px"}),e.blockUI&&(e.unblockUI(),e("body").append(this.dpDiv))),this._inDialog=!1)},_tidyDialog:function(e){e.dpDiv.removeClass(this._dialogClass).unbind(".ui-datepicker-calendar")},_checkExternalClick:function(t){if(e.datepicker._curInst){var i=e(t.target),s=e.datepicker._getInst(i[0]);(i[0].id!==e.datepicker._mainDivId&&0===i.parents("#"+e.datepicker._mainDivId).length&&!i.hasClass(e.datepicker.markerClassName)&&!i.closest("."+e.datepicker._triggerClass).length&&e.datepicker._datepickerShowing&&(!e.datepicker._inDialog||!e.
blockUI)||i.hasClass(e.datepicker.markerClassName)&&e.datepicker._curInst!==s)&&e.datepicker._hideDatepicker()}},_adjustDate:function(t,i,s){var n=e(t),a=this._getInst(n[0]);this._isDisabledDatepicker(n[0])||(this._adjustInstDate(a,i+("M"===s?this._get(a,"showCurrentAtPos"):0),s),this._updateDatepicker(a))},_gotoToday:function(t){var i,s=e(t),n=this._getInst(s[0]);this._get(n,"gotoCurrent")&&n.currentDay?(n.selectedDay=n.currentDay,n.drawMonth=n.selectedMonth=n.currentMonth,n.drawYear=n.selectedYear=n.currentYear):(i=new Date,n.selectedDay=i.getDate(),n.drawMonth=n.selectedMonth=i.getMonth(),n.drawYear=n.selectedYear=i.getFullYear()),this._notifyChange(n),this._adjustDate(s)},_selectMonthYear:function(t,i,s){var n=e(t),a=this._getInst(n[0]);a["selected"+("M"===s?"Month":"Year")]=a["draw"+("M"===s?"Month":"Year")]=parseInt(i.options[i.selectedIndex].value,10),this._notifyChange(a),this._adjustDate(n)},_selectDay:function(t,i,s,n){var a,o=e(t);e(n).hasClass(this._unselectableClass)||t
his._isDisabledDatepicker(o[0])||(a=this._getInst(o[0]),a.selectedDay=a.currentDay=e("a",n).html(),a.selectedMonth=a.currentMonth=i,a.selectedYear=a.currentYear=s,this._selectDate(t,this._formatDate(a,a.currentDay,a.currentMonth,a.currentYear)))},_clearDate:function(t){var i=e(t);this._selectDate(i,"")},_selectDate:function(t,i){var s,n=e(t),a=this._getInst(n[0]);i=null!=i?i:this._formatDate(a),a.input&&a.input.val(i),this._updateAlternate(a),s=this._get(a,"onSelect"),s?s.apply(a.input?a.input[0]:null,[i,a]):a.input&&a.input.trigger("change"),a.inline?this._updateDatepicker(a):(this._hideDatepicker(),this._lastInput=a.input[0],"object"!=typeof a.input[0]&&a.input.focus(),this._lastInput=null)},_updateAlternate:function(t){var i,s,n,a=this._get(t,"altField");a&&(i=this._get(t,"altFormat")||this._get(t,"dateFormat"),s=this._getDate(t),n=this.formatDate(i,s,this._getFormatConfig(t)),e(a).each(function(){e(this).val(n)}))},noWeekends:function(e){var t=e.getDay();return[t>0&&6>t,""]},iso
8601Week:function(e){var t,i=new Date(e.getTime());return i.setDate(i.getDate()+4-(i.getDay()||7)),t=i.getTime(),i.setMonth(0),i.setDate(1),Math.floor(Math.round((t-i)/864e5)/7)+1},parseDate:function(t,i,s){if(null==t||null==i)throw"Invalid arguments";if(i="object"==typeof i?""+i:i+"",""===i)return null;var n,a,o,r,h=0,l=(s?s.shortYearCutoff:null)||this._defaults.shortYearCutoff,u="string"!=typeof l?l:(new Date).getFullYear()%100+parseInt(l,10),d=(s?s.dayNamesShort:null)||this._defaults.dayNamesShort,c=(s?s.dayNames:null)||this._defaults.dayNames,p=(s?s.monthNamesShort:null)||this._defaults.monthNamesShort,f=(s?s.monthNames:null)||this._defaults.monthNames,m=-1,g=-1,v=-1,y=-1,b=!1,_=function(e){var i=t.length>n+1&&t.charAt(n+1)===e;return i&&n++,i},x=function(e){var t=_(e),s="@"===e?14:"!"===e?20:"y"===e&&t?4:"o"===e?3:2,n="y"===e?s:1,a=RegExp("^\\d{"+n+","+s+"}"),o=i.substring(h).match(a);if(!o)throw"Missing number at position "+h;return h+=o[0].length,parseInt(o[0],10)},w=function
(t,s,n){var a=-1,o=e.map(_(t)?n:s,function(e,t){return[[t,e]]}).sort(function(e,t){return-(e[1].length-t[1].length)});if(e.each(o,function(e,t){var s=t[1];return i.substr(h,s.length).toLowerCase()===s.toLowerCase()?(a=t[0],h+=s.length,!1):void 0}),-1!==a)return a+1;throw"Unknown name at position "+h},k=function(){if(i.charAt(h)!==t.charAt(n))throw"Unexpected literal at position "+h;h++};for(n=0;t.length>n;n++)if(b)"'"!==t.charAt(n)||_("'")?k():b=!1;else switch(t.charAt(n)){case"d":v=x("d");break;case"D":w("D",d,c);break;case"o":y=x("o");break;case"m":g=x("m");break;case"M":g=w("M",p,f);break;case"y":m=x("y");break;case"@":r=new Date(x("@")),m=r.getFullYear(),g=r.getMonth()+1,v=r.getDate();break;case"!":r=new Date((x("!")-this._ticksTo1970)/1e4),m=r.getFullYear(),g=r.getMonth()+1,v=r.getDate();break;case"'":_("'")?k():b=!0;break;default:k()}if(i.length>h&&(o=i.substr(h),!/^\s+/.test(o)))throw"Extra/unparsed characters found in date: "+o;if(-1===m?m=(new Date).getFullYear():100>m&&(m+
=(new Date).getFullYear()-(new Date).getFullYear()%100+(u>=m?0:-100)),y>-1)for(g=1,v=y;;){if(a=this._getDaysInMonth(m,g-1),a>=v)break;g++,v-=a}if(r=this._daylightSavingAdjust(new Date(m,g-1,v)),r.getFullYear()!==m||r.getMonth()+1!==g||r.getDate()!==v)throw"Invalid date";return r},ATOM:"yy-mm-dd",COOKIE:"D, dd M yy",ISO_8601:"yy-mm-dd",RFC_822:"D, d M y",RFC_850:"DD, dd-M-y",RFC_1036:"D, d M y",RFC_1123:"D, d M yy",RFC_2822:"D, d M yy",RSS:"D, d M y",TICKS:"!",TIMESTAMP:"@",W3C:"yy-mm-dd",_ticksTo1970:1e7*60*60*24*(718685+Math.floor(492.5)-Math.floor(19.7)+Math.floor(4.925)),formatDate:function(e,t,i){if(!t)return"";var s,n=(i?i.dayNamesShort:null)||this._defaults.dayNamesShort,a=(i?i.dayNames:null)||this._defaults.dayNames,o=(i?i.monthNamesShort:null)||this._defaults.monthNamesShort,r=(i?i.monthNames:null)||this._defaults.monthNames,h=function(t){var i=e.length>s+1&&e.charAt(s+1)===t;return i&&s++,i},l=function(e,t,i){var s=""+t;if(h(e))for(;i>s.length;)s="0"+s;return s},u=function(
e,t,i,s){return h(e)?s[t]:i[t]},d="",c=!1;if(t)for(s=0;e.length>s;s++)if(c)"'"!==e.charAt(s)||h("'")?d+=e.charAt(s):c=!1;else switch(e.charAt(s)){case"d":d+=l("d",t.getDate(),2);break;case"D":d+=u("D",t.getDay(),n,a);break;case"o":d+=l("o",Math.round((new Date(t.getFullYear(),t.getMonth(),t.getDate()).getTime()-new Date(t.getFullYear(),0,0).getTime())/864e5),3);break;case"m":d+=l("m",t.getMonth()+1,2);break;case"M":d+=u("M",t.getMonth(),o,r);break;case"y":d+=h("y")?t.getFullYear():(10>t.getYear()%100?"0":"")+t.getYear()%100;break;case"@":d+=t.getTime();break;case"!":d+=1e4*t.getTime()+this._ticksTo1970;break;case"'":h("'")?d+="'":c=!0;break;default:d+=e.charAt(s)}return d},_possibleChars:function(e){var t,i="",s=!1,n=function(i){var s=e.length>t+1&&e.charAt(t+1)===i;return s&&t++,s};for(t=0;e.length>t;t++)if(s)"'"!==e.charAt(t)||n("'")?i+=e.charAt(t):s=!1;else switch(e.charAt(t)){case"d":case"m":case"y":case"@":i+="0123456789";break;case"D":case"M":return null;case"'":n("'")?i+="'":
s=!0;break;default:i+=e.charAt(t)}return i},_get:function(e,t){return void 0!==e.settings[t]?e.settings[t]:this._defaults[t]},_setDateFromField:function(e,t){if(e.input.val()!==e.lastVal){var i=this._get(e,"dateFormat"),s=e.lastVal=e.input?e.input.val():null,n=this._getDefaultDate(e),a=n,o=this._getFormatConfig(e);try{a=this.parseDate(i,s,o)||n}catch(r){s=t?"":s}e.selectedDay=a.getDate(),e.drawMonth=e.selectedMonth=a.getMonth(),e.drawYear=e.selectedYear=a.getFullYear(),e.currentDay=s?a.getDate():0,e.currentMonth=s?a.getMonth():0,e.currentYear=s?a.getFullYear():0,this._adjustInstDate(e)}},_getDefaultDate:function(e){return this._restrictMinMax(e,this._determineDate(e,this._get(e,"defaultDate"),new Date))},_determineDate:function(t,i,s){var n=function(e){var t=new Date;return t.setDate(t.getDate()+e),t},a=function(i){try{return e.datepicker.parseDate(e.datepicker._get(t,"dateFormat"),i,e.datepicker._getFormatConfig(t))}catch(s){}for(var n=(i.toLowerCase().match(/^c/)?e.datepicker._get
Date(t):null)||new Date,a=n.getFullYear(),o=n.getMonth(),r=n.getDate(),h=/([+\-]?[0-9]+)\s*(d|D|w|W|m|M|y|Y)?/g,l=h.exec(i);l;){switch(l[2]||"d"){case"d":case"D":r+=parseInt(l[1],10);break;case"w":case"W":r+=7*parseInt(l[1],10);break;case"m":case"M":o+=parseInt(l[1],10),r=Math.min(r,e.datepicker._getDaysInMonth(a,o));break;case"y":case"Y":a+=parseInt(l[1],10),r=Math.min(r,e.datepicker._getDaysInMonth(a,o))}l=h.exec(i)}return new Date(a,o,r)},o=null==i||""===i?s:"string"==typeof i?a(i):"number"==typeof i?isNaN(i)?s:n(i):new Date(i.getTime());return o=o&&"Invalid Date"==""+o?s:o,o&&(o.setHours(0),o.setMinutes(0),o.setSeconds(0),o.setMilliseconds(0)),this._daylightSavingAdjust(o)},_daylightSavingAdjust:function(e){return e?(e.setHours(e.getHours()>12?e.getHours()+2:0),e):null},_setDate:function(e,t,i){var s=!t,n=e.selectedMonth,a=e.selectedYear,o=this._restrictMinMax(e,this._determineDate(e,t,new Date));e.selectedDay=e.currentDay=o.getDate(),e.drawMonth=e.selectedMonth=e.currentMonth=o
.getMonth(),e.drawYear=e.selectedYear=e.currentYear=o.getFullYear(),n===e.selectedMonth&&a===e.selectedYear||i||this._notifyChange(e),this._adjustInstDate(e),e.input&&e.input.val(s?"":this._formatDate(e))},_getDate:function(e){var t=!e.currentYear||e.input&&""===e.input.val()?null:this._daylightSavingAdjust(new Date(e.currentYear,e.currentMonth,e.currentDay));return t},_attachHandlers:function(t){var i=this._get(t,"stepMonths"),s="#"+t.id.replace(/\\\\/g,"\\");t.dpDiv.find("[data-handler]").map(function(){var t={prev:function(){e.datepicker._adjustDate(s,-i,"M")},next:function(){e.datepicker._adjustDate(s,+i,"M")},hide:function(){e.datepicker._hideDatepicker()},today:function(){e.datepicker._gotoToday(s)},selectDay:function(){return e.datepicker._selectDay(s,+this.getAttribute("data-month"),+this.getAttribute("data-year"),this),!1},selectMonth:function(){return e.datepicker._selectMonthYear(s,this,"M"),!1},selectYear:function(){return e.datepicker._selectMonthYear(s,this,"Y"),!1}};e
(this).bind(this.getAttribute("data-event"),t[this.getAttribute("data-handler")])})},_generateHTML:function(e){var t,i,s,n,a,o,r,h,l,u,d,c,p,f,m,g,v,y,b,_,x,w,k,T,D,S,M,C,N,A,P,I,H,z,F,E,O,j,W,L=new Date,R=this._daylightSavingAdjust(new Date(L.getFullYear(),L.getMonth(),L.getDate())),Y=this._get(e,"isRTL"),B=this._get(e,"showButtonPanel"),J=this._get(e,"hideIfNoPrevNext"),q=this._get(e,"navigationAsDateFormat"),K=this._getNumberOfMonths(e),V=this._get(e,"showCurrentAtPos"),U=this._get(e,"stepMonths"),Q=1!==K[0]||1!==K[1],G=this._daylightSavingAdjust(e.currentDay?new Date(e.currentYear,e.currentMonth,e.currentDay):new Date(9999,9,9)),X=this._getMinMaxDate(e,"min"),$=this._getMinMaxDate(e,"max"),Z=e.drawMonth-V,et=e.drawYear;if(0>Z&&(Z+=12,et--),$)for(t=this._daylightSavingAdjust(new Date($.getFullYear(),$.getMonth()-K[0]*K[1]+1,$.getDate())),t=X&&X>t?X:t;this._daylightSavingAdjust(new Date(et,Z,1))>t;)Z--,0>Z&&(Z=11,et--);for(e.drawMonth=Z,e.drawYear=et,i=this._get(e,"prevText"),i=q?
this.formatDate(i,this._daylightSavingAdjust(new Date(et,Z-U,1)),this._getFormatConfig(e)):i,s=this._canAdjustMonth(e,-1,et,Z)?"<a class='ui-datepicker-prev ui-corner-all' data-handler='prev' data-event='click' title='"+i+"'><span class='ui-icon ui-icon-circle-triangle-"+(Y?"e":"w")+"'>"+i+"</span></a>":J?"":"<a class='ui-datepicker-prev ui-corner-all ui-state-disabled' title='"+i+"'><span class='ui-icon ui-icon-circle-triangle-"+(Y?"e":"w")+"'>"+i+"</span></a>",n=this._get(e,"nextText"),n=q?this.formatDate(n,this._daylightSavingAdjust(new Date(et,Z+U,1)),this._getFormatConfig(e)):n,a=this._canAdjustMonth(e,1,et,Z)?"<a class='ui-datepicker-next ui-corner-all' data-handler='next' data-event='click' title='"+n+"'><span class='ui-icon ui-icon-circle-triangle-"+(Y?"w":"e")+"'>"+n+"</span></a>":J?"":"<a class='ui-datepicker-next ui-corner-all ui-state-disabled' title='"+n+"'><span class='ui-icon ui-icon-circle-triangle-"+(Y?"w":"e")+"'>"+n+"</span></a>",o=this._get(e,"currentText"),r=thi
s._get(e,"gotoCurrent")&&e.currentDay?G:R,o=q?this.formatDate(o,r,this._getFormatConfig(e)):o,h=e.inline?"":"<button type='button' class='ui-datepicker-close ui-state-default ui-priority-primary ui-corner-all' data-handler='hide' data-event='click'>"+this._get(e,"closeText")+"</button>",l=B?"<div class='ui-datepicker-buttonpane ui-widget-content'>"+(Y?h:"")+(this._isInRange(e,r)?"<button type='button' class='ui-datepicker-current ui-state-default ui-priority-secondary ui-corner-all' data-handler='today' data-event='click'>"+o+"</button>":"")+(Y?"":h)+"</div>":"",u=parseInt(this._get(e,"firstDay"),10),u=isNaN(u)?0:u,d=this._get(e,"showWeek"),c=this._get(e,"dayNames"),p=this._get(e,"dayNamesMin"),f=this._get(e,"monthNames"),m=this._get(e,"monthNamesShort"),g=this._get(e,"beforeShowDay"),v=this._get(e,"showOtherMonths"),y=this._get(e,"selectOtherMonths"),b=this._getDefaultDate(e),_="",w=0;K[0]>w;w++){for(k="",this.maxRows=4,T=0;K[1]>T;T++){if(D=this._daylightSavingAdjust(new Date(et,Z,
e.selectedDay)),S=" ui-corner-all",M="",Q){if(M+="<div class='ui-datepicker-group",K[1]>1)switch(T){case 0:M+=" ui-datepicker-group-first",S=" ui-corner-"+(Y?"right":"left");break;case K[1]-1:M+=" ui-datepicker-group-last",S=" ui-corner-"+(Y?"left":"right");break;default:M+=" ui-datepicker-group-middle",S=""}M+="'>"}for(M+="<div class='ui-datepicker-header ui-widget-header ui-helper-clearfix"+S+"'>"+(/all|left/.test(S)&&0===w?Y?a:s:"")+(/all|right/.test(S)&&0===w?Y?s:a:"")+this._generateMonthYearHeader(e,Z,et,X,$,w>0||T>0,f,m)+"</div><table class='ui-datepicker-calendar'><thead>"+"<tr>",C=d?"<th class='ui-datepicker-week-col'>"+this._get(e,"weekHeader")+"</th>":"",x=0;7>x;x++)N=(x+u)%7,C+="<th scope='col'"+((x+u+6)%7>=5?" class='ui-datepicker-week-end'":"")+">"+"<span title='"+c[N]+"'>"+p[N]+"</span></th>";for(M+=C+"</tr></thead><tbody>",A=this._getDaysInMonth(et,Z),et===e.selectedYear&&Z===e.selectedMonth&&(e.selectedDay=Math.min(e.selectedDay,A)),P=(this._getFirstDayOfMonth(et,Z)-
u+7)%7,I=Math.ceil((P+A)/7),H=Q?this.maxRows>I?this.maxRows:I:I,this.maxRows=H,z=this._daylightSavingAdjust(new Date(et,Z,1-P)),F=0;H>F;F++){for(M+="<tr>",E=d?"<td class='ui-datepicker-week-col'>"+this._get(e,"calculateWeek")(z)+"</td>":"",x=0;7>x;x++)O=g?g.apply(e.input?e.input[0]:null,[z]):[!0,""],j=z.getMonth()!==Z,W=j&&!y||!O[0]||X&&X>z||$&&z>$,E+="<td class='"+((x+u+6)%7>=5?" ui-datepicker-week-end":"")+(j?" ui-datepicker-other-month":"")+(z.getTime()===D.getTime()&&Z===e.selectedMonth&&e._keyEvent||b.getTime()===z.getTime()&&b.getTime()===D.getTime()?" "+this._dayOverClass:"")+(W?" "+this._unselectableClass+" ui-state-disabled":"")+(j&&!v?"":" "+O[1]+(z.getTime()===G.getTime()?" "+this._currentClass:"")+(z.getTime()===R.getTime()?" ui-datepicker-today":""))+"'"+(j&&!v||!O[2]?"":" title='"+O[2].replace(/'/g,"'")+"'")+(W?"":" data-handler='selectDay' data-event='click' data-month='"+z.getMonth()+"' data-year='"+z.getFullYear()+"'")+">"+(j&&!v?" ":W?"<span class='ui-stat
e-default'>"+z.getDate()+"</span>":"<a class='ui-state-default"+(z.getTime()===R.getTime()?" ui-state-highlight":"")+(z.getTime()===G.getTime()?" ui-state-active":"")+(j?" ui-priority-secondary":"")+"' href='#'>"+z.getDate()+"</a>")+"</td>",z.setDate(z.getDate()+1),z=this._daylightSavingAdjust(z);M+=E+"</tr>"}Z++,Z>11&&(Z=0,et++),M+="</tbody></table>"+(Q?"</div>"+(K[0]>0&&T===K[1]-1?"<div class='ui-datepicker-row-break'></div>":""):""),k+=M}_+=k}return _+=l,e._keyEvent=!1,_},_generateMonthYearHeader:function(e,t,i,s,n,a,o,r){var h,l,u,d,c,p,f,m,g=this._get(e,"changeMonth"),v=this._get(e,"changeYear"),y=this._get(e,"showMonthAfterYear"),b="<div class='ui-datepicker-title'>",_="";if(a||!g)_+="<span class='ui-datepicker-month'>"+o[t]+"</span>";else{for(h=s&&s.getFullYear()===i,l=n&&n.getFullYear()===i,_+="<select class='ui-datepicker-month' data-handler='selectMonth' data-event='change'>",u=0;12>u;u++)(!h||u>=s.getMonth())&&(!l||n.getMonth()>=u)&&(_+="<option value='"+u+"'"+(u===t?" se
lected='selected'":"")+">"+r[u]+"</option>");_+="</select>"}if(y||(b+=_+(!a&&g&&v?"":" ")),!e.yearshtml)if(e.yearshtml="",a||!v)b+="<span class='ui-datepicker-year'>"+i+"</span>";else{for(d=this._get(e,"yearRange").split(":"),c=(new Date).getFullYear(),p=function(e){var t=e.match(/c[+\-].*/)?i+parseInt(e.substring(1),10):e.match(/[+\-].*/)?c+parseInt(e,10):parseInt(e,10);return isNaN(t)?c:t},f=p(d[0]),m=Math.max(f,p(d[1]||"")),f=s?Math.max(f,s.getFullYear()):f,m=n?Math.min(m,n.getFullYear()):m,e.yearshtml+="<select class='ui-datepicker-year' data-handler='selectYear' data-event='change'>";m>=f;f++)e.yearshtml+="<option value='"+f+"'"+(f===i?" selected='selected'":"")+">"+f+"</option>";e.yearshtml+="</select>",b+=e.yearshtml,e.yearshtml=null}return b+=this._get(e,"yearSuffix"),y&&(b+=(!a&&g&&v?"":" ")+_),b+="</div>"},_adjustInstDate:function(e,t,i){var s=e.drawYear+("Y"===i?t:0),n=e.drawMonth+("M"===i?t:0),a=Math.min(e.selectedDay,this._getDaysInMonth(s,n))+("D"===i?t:0),o=
this._restrictMinMax(e,this._daylightSavingAdjust(new Date(s,n,a)));e.selectedDay=o.getDate(),e.drawMonth=e.selectedMonth=o.getMonth(),e.drawYear=e.selectedYear=o.getFullYear(),("M"===i||"Y"===i)&&this._notifyChange(e)},_restrictMinMax:function(e,t){var i=this._getMinMaxDate(e,"min"),s=this._getMinMaxDate(e,"max"),n=i&&i>t?i:t;return s&&n>s?s:n},_notifyChange:function(e){var t=this._get(e,"onChangeMonthYear");t&&t.apply(e.input?e.input[0]:null,[e.selectedYear,e.selectedMonth+1,e])},_getNumberOfMonths:function(e){var t=this._get(e,"numberOfMonths");return null==t?[1,1]:"number"==typeof t?[1,t]:t},_getMinMaxDate:function(e,t){return this._determineDate(e,this._get(e,t+"Date"),null)},_getDaysInMonth:function(e,t){return 32-this._daylightSavingAdjust(new Date(e,t,32)).getDate()},_getFirstDayOfMonth:function(e,t){return new Date(e,t,1).getDay()},_canAdjustMonth:function(e,t,i,s){var n=this._getNumberOfMonths(e),a=this._daylightSavingAdjust(new Date(i,s+(0>t?t:n[0]*n[1]),1));return 0>t&&a
.setDate(this._getDaysInMonth(a.getFullYear(),a.getMonth())),this._isInRange(e,a)},_isInRange:function(e,t){var i,s,n=this._getMinMaxDate(e,"min"),a=this._getMinMaxDate(e,"max"),o=null,r=null,h=this._get(e,"yearRange");return h&&(i=h.split(":"),s=(new Date).getFullYear(),o=parseInt(i[0],10),r=parseInt(i[1],10),i[0].match(/[+\-].*/)&&(o+=s),i[1].match(/[+\-].*/)&&(r+=s)),(!n||t.getTime()>=n.getTime())&&(!a||t.getTime()<=a.getTime())&&(!o||t.getFullYear()>=o)&&(!r||r>=t.getFullYear())},_getFormatConfig:function(e){var t=this._get(e,"shortYearCutoff");return t="string"!=typeof t?t:(new Date).getFullYear()%100+parseInt(t,10),{shortYearCutoff:t,dayNamesShort:this._get(e,"dayNamesShort"),dayNames:this._get(e,"dayNames"),monthNamesShort:this._get(e,"monthNamesShort"),monthNames:this._get(e,"monthNames")}},_formatDate:function(e,t,i,s){t||(e.currentDay=e.selectedDay,e.currentMonth=e.selectedMonth,e.currentYear=e.selectedYear);var n=t?"object"==typeof t?t:this._daylightSavingAdjust(new Date(
s,i,t)):this._daylightSavingAdjust(new Date(e.currentYear,e.currentMonth,e.currentDay));return this.formatDate(this._get(e,"dateFormat"),n,this._getFormatConfig(e))}}),e.fn.datepicker=function(t){if(!this.length)return this;e.datepicker.initialized||(e(document).mousedown(e.datepicker._checkExternalClick),e.datepicker.initialized=!0),0===e("#"+e.datepicker._mainDivId).length&&e("body").append(e.datepicker.dpDiv);var i=Array.prototype.slice.call(arguments,1);return"string"!=typeof t||"isDisabled"!==t&&"getDate"!==t&&"widget"!==t?"option"===t&&2===arguments.length&&"string"==typeof arguments[1]?e.datepicker["_"+t+"Datepicker"].apply(e.datepicker,[this[0]].concat(i)):this.each(function(){"string"==typeof t?e.datepicker["_"+t+"Datepicker"].apply(e.datepicker,[this].concat(i)):e.datepicker._attachDatepicker(this,t)}):e.datepicker["_"+t+"Datepicker"].apply(e.datepicker,[this[0]].concat(i))},e.datepicker=new n,e.datepicker.initialized=!1,e.datepicker.uuid=(new Date).getTime(),e.datepicker.
version="1.11.4",e.datepicker,e.widget("ui.draggable",e.ui.mouse,{version:"1.11.4",widgetEventPrefix:"drag",options:{addClasses:!0,appendTo:"parent",axis:!1,connectToSortable:!1,containment:!1,cursor:"auto",cursorAt:!1,grid:!1,handle:!1,helper:"original",iframeFix:!1,opacity:!1,refreshPos
<TRUNCATED>
[5/6] isis git commit: ISIS-1133: styling of tocify,
and downloading its css and js dependencies so can run offline.
Posted by da...@apache.org.
ISIS-1133: styling of tocify, and downloading its css and js dependencies so can run offline.
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/b05b63e4
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/b05b63e4
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/b05b63e4
Branch: refs/heads/master
Commit: b05b63e437a2255a0a8356c96674d67f90edd69d
Parents: 4d0478a
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Fri May 15 19:18:17 2015 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Fri May 15 19:18:17 2015 +0100
----------------------------------------------------------------------
.../css/jquery.tocify/1.9.0/jquery.tocify.css | 62 ++
.../js/jquery.tocify/1.9.0/jquery.tocify.js | 987 +++++++++++++++++++
.../js/jqueryui/1.11.4/jquery-ui.min.js | 13 +
..._reference_services-api_wrapper-factory.adoc | 10 +
...ting_integ-test-support_wrapper-factory.adoc | 35 +-
.../main/asciidoc/user-guide/user-guide.adoc | 26 +-
adocs/template/document.html.erb | 30 +-
7 files changed, 1118 insertions(+), 45 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/b05b63e4/adocs/documentation/src/main/asciidoc/css/jquery.tocify/1.9.0/jquery.tocify.css
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/css/jquery.tocify/1.9.0/jquery.tocify.css b/adocs/documentation/src/main/asciidoc/css/jquery.tocify/1.9.0/jquery.tocify.css
new file mode 100644
index 0000000..9c9ffdc
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/css/jquery.tocify/1.9.0/jquery.tocify.css
@@ -0,0 +1,62 @@
+/*
+ * jquery.tocify.css 1.9.0
+ * Author: @gregfranko
+ */
+
+/* The Table of Contents container element */
+.tocify {
+ width: 20%;
+ max-height: 90%;
+ overflow: auto;
+ margin-left: 2%;
+ position: fixed;
+ border: 1px solid #ccc;
+ webkit-border-radius: 6px;
+ moz-border-radius: 6px;
+ border-radius: 6px;
+}
+
+/* The Table of Contents is composed of multiple nested unordered lists. These styles remove the default styling of an unordered list because it is ugly. */
+.tocify ul, .tocify li {
+ list-style: none;
+ margin: 0;
+ padding: 0;
+ border: none;
+ line-height: 30px;
+}
+
+/* Top level header elements */
+.tocify-header {
+ text-indent: 10px;
+}
+
+/* Top level subheader elements. These are the first nested items underneath a header element. */
+.tocify-subheader {
+ text-indent: 20px;
+ display: none;
+}
+
+/* Makes the font smaller for all subheader elements. */
+.tocify-subheader li {
+ font-size: 12px;
+}
+
+/* Further indents second level subheader elements. */
+.tocify-subheader .tocify-subheader {
+ text-indent: 30px;
+}
+
+/* Further indents third level subheader elements. You can continue this pattern if you have more nested elements. */
+.tocify-subheader .tocify-subheader .tocify-subheader {
+ text-indent: 40px;
+}
+
+/* Twitter Bootstrap Override Style */
+.nav-list > li > a, .nav-list .nav-header {
+ margin: 0px;
+}
+
+/* Twitter Bootstrap Override Style */
+.nav-list > li > a {
+ padding: 5px;
+}
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/b05b63e4/adocs/documentation/src/main/asciidoc/js/jquery.tocify/1.9.0/jquery.tocify.js
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/js/jquery.tocify/1.9.0/jquery.tocify.js b/adocs/documentation/src/main/asciidoc/js/jquery.tocify/1.9.0/jquery.tocify.js
new file mode 100644
index 0000000..f464d95
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/js/jquery.tocify/1.9.0/jquery.tocify.js
@@ -0,0 +1,987 @@
+/* jquery Tocify - v1.9.0 - 2013-10-01
+* http://www.gregfranko.com/jquery.tocify.js/
+* Copyright (c) 2013 Greg Franko; Licensed MIT */
+
+// Immediately-Invoked Function Expression (IIFE) [Ben Alman Blog Post](http://benalman.com/news/2010/11/immediately-invoked-function-expression/) that calls another IIFE that contains all of the plugin logic. I used this pattern so that anyone viewing this code would not have to scroll to the bottom of the page to view the local parameters that were passed to the main IIFE.
+(function(tocify) {
+
+ // ECMAScript 5 Strict Mode: [John Resig Blog Post](http://ejohn.org/blog/ecmascript-5-strict-mode-json-and-more/)
+ "use strict";
+
+ // Calls the second IIFE and locally passes in the global jQuery, window, and document objects
+ tocify(window.jQuery, window, document);
+
+}
+
+// Locally passes in `jQuery`, the `window` object, the `document` object, and an `undefined` variable. The `jQuery`, `window` and `document` objects are passed in locally, to improve performance, since javascript first searches for a variable match within the local variables set before searching the global variables set. All of the global variables are also passed in locally to be minifier friendly. `undefined` can be passed in locally, because it is not a reserved word in JavaScript.
+(function($, window, document, undefined) {
+
+ // ECMAScript 5 Strict Mode: [John Resig Blog Post](http://ejohn.org/blog/ecmascript-5-strict-mode-json-and-more/)
+ "use strict";
+
+ var tocClassName = "tocify",
+ tocClass = "." + tocClassName,
+ tocFocusClassName = "tocify-focus",
+ tocHoverClassName = "tocify-hover",
+ hideTocClassName = "tocify-hide",
+ hideTocClass = "." + hideTocClassName,
+ headerClassName = "tocify-header",
+ headerClass = "." + headerClassName,
+ subheaderClassName = "tocify-subheader",
+ subheaderClass = "." + subheaderClassName,
+ itemClassName = "tocify-item",
+ itemClass = "." + itemClassName,
+ extendPageClassName = "tocify-extend-page",
+ extendPageClass = "." + extendPageClassName;
+
+ // Calling the jQueryUI Widget Factory Method
+ $.widget("toc.tocify", {
+
+ //Plugin version
+ version: "1.9.0",
+
+ // These options will be used as defaults
+ options: {
+
+ // **context**: Accepts String: Any jQuery selector
+ // The container element that holds all of the elements used to generate the table of contents
+ context: "body",
+
+ // **ignoreSelector**: Accepts String: Any jQuery selector
+ // A selector to any element that would be matched by selectors that you wish to be ignored
+ ignoreSelector: null,
+
+ // **selectors**: Accepts an Array of Strings: Any jQuery selectors
+ // The element's used to generate the table of contents. The order is very important since it will determine the table of content's nesting structure
+ selectors: "h1, h2, h3",
+
+ // **showAndHide**: Accepts a boolean: true or false
+ // Used to determine if elements should be shown and hidden
+ showAndHide: true,
+
+ // **showEffect**: Accepts String: "none", "fadeIn", "show", or "slideDown"
+ // Used to display any of the table of contents nested items
+ showEffect: "slideDown",
+
+ // **showEffectSpeed**: Accepts Number (milliseconds) or String: "slow", "medium", or "fast"
+ // The time duration of the show animation
+ showEffectSpeed: "medium",
+
+ // **hideEffect**: Accepts String: "none", "fadeOut", "hide", or "slideUp"
+ // Used to hide any of the table of contents nested items
+ hideEffect: "slideUp",
+
+ // **hideEffectSpeed**: Accepts Number (milliseconds) or String: "slow", "medium", or "fast"
+ // The time duration of the hide animation
+ hideEffectSpeed: "medium",
+
+ // **smoothScroll**: Accepts a boolean: true or false
+ // Determines if a jQuery animation should be used to scroll to specific table of contents items on the page
+ smoothScroll: true,
+
+ // **smoothScrollSpeed**: Accepts Number (milliseconds) or String: "slow", "medium", or "fast"
+ // The time duration of the smoothScroll animation
+ smoothScrollSpeed: "medium",
+
+ // **scrollTo**: Accepts Number (pixels)
+ // The amount of space between the top of page and the selected table of contents item after the page has been scrolled
+ scrollTo: 0,
+
+ // **showAndHideOnScroll**: Accepts a boolean: true or false
+ // Determines if table of contents nested items should be shown and hidden while scrolling
+ showAndHideOnScroll: true,
+
+ // **highlightOnScroll**: Accepts a boolean: true or false
+ // Determines if table of contents nested items should be highlighted (set to a different color) while scrolling
+ highlightOnScroll: true,
+
+ // **highlightOffset**: Accepts a number
+ // The offset distance in pixels to trigger the next active table of contents item
+ highlightOffset: 40,
+
+ // **theme**: Accepts a string: "bootstrap", "jqueryui", or "none"
+ // Determines if Twitter Bootstrap, jQueryUI, or Tocify classes should be added to the table of contents
+ theme: "bootstrap",
+
+ // **extendPage**: Accepts a boolean: true or false
+ // If a user scrolls to the bottom of the page and the page is not tall enough to scroll to the last table of contents item, then the page height is increased
+ extendPage: true,
+
+ // **extendPageOffset**: Accepts a number: pixels
+ // How close to the bottom of the page a user must scroll before the page is extended
+ extendPageOffset: 100,
+
+ // **history**: Accepts a boolean: true or false
+ // Adds a hash to the page url to maintain history
+ history: true,
+
+ // **scrollHistory**: Accepts a boolean: true or false
+ // Adds a hash to the page url, to maintain history, when scrolling to a TOC item
+ scrollHistory: false,
+
+ // **hashGenerator**: How the hash value (the anchor segment of the URL, following the
+ // # character) will be generated.
+ //
+ // "compact" (default) - #CompressesEverythingTogether
+ // "pretty" - #looks-like-a-nice-url-and-is-easily-readable
+ // function(text, element){} - Your own hash generation function that accepts the text as an
+ // argument, and returns the hash value.
+ hashGenerator: "compact",
+
+ // **highlightDefault**: Accepts a boolean: true or false
+ // Set's the first TOC item as active if no other TOC item is active.
+ highlightDefault: true
+
+ },
+
+ // _Create
+ // -------
+ // Constructs the plugin. Only called once.
+ _create: function() {
+
+ var self = this;
+
+ self.extendPageScroll = true;
+
+ // Internal array that keeps track of all TOC items (Helps to recognize if there are duplicate TOC item strings)
+ self.items = [];
+
+ // Generates the HTML for the dynamic table of contents
+ self._generateToc();
+
+ // Adds CSS classes to the newly generated table of contents HTML
+ self._addCSSClasses();
+
+ self.webkit = (function() {
+
+ for(var prop in window) {
+
+ if(prop) {
+
+ if(prop.toLowerCase().indexOf("webkit") !== -1) {
+
+ return true;
+
+ }
+
+ }
+
+ }
+
+ return false;
+
+ }());
+
+ // Adds jQuery event handlers to the newly generated table of contents
+ self._setEventHandlers();
+
+ // Binding to the Window load event to make sure the correct scrollTop is calculated
+ $(window).load(function() {
+
+ // Sets the active TOC item
+ self._setActiveElement(true);
+
+ // Once all animations on the page are complete, this callback function will be called
+ $("html, body").promise().done(function() {
+
+ setTimeout(function() {
+
+ self.extendPageScroll = false;
+
+ },0);
+
+ });
+
+ });
+
+ },
+
+ // _generateToc
+ // ------------
+ // Generates the HTML for the dynamic table of contents
+ _generateToc: function() {
+
+ // _Local variables_
+
+ // Stores the plugin context in the self variable
+ var self = this,
+
+ // All of the HTML tags found within the context provided (i.e. body) that match the top level jQuery selector above
+ firstElem,
+
+ // Instantiated variable that will store the top level newly created unordered list DOM element
+ ul,
+ ignoreSelector = self.options.ignoreSelector;
+
+ // If the selectors option has a comma within the string
+ if(this.options.selectors.indexOf(",") !== -1) {
+
+ // Grabs the first selector from the string
+ firstElem = $(this.options.context).find(this.options.selectors.replace(/ /g,"").substr(0, this.options.selectors.indexOf(",")));
+
+ }
+
+ // If the selectors option does not have a comman within the string
+ else {
+
+ // Grabs the first selector from the string and makes sure there are no spaces
+ firstElem = $(this.options.context).find(this.options.selectors.replace(/ /g,""));
+
+ }
+
+ if(!firstElem.length) {
+
+ self.element.addClass(hideTocClassName);
+
+ return;
+
+ }
+
+ self.element.addClass(tocClassName);
+
+ // Loops through each top level selector
+ firstElem.each(function(index) {
+
+ //If the element matches the ignoreSelector then we skip it
+ if($(this).is(ignoreSelector)) {
+ return;
+ }
+
+ // Creates an unordered list HTML element and adds a dynamic ID and standard class name
+ ul = $("<ul/>", {
+ "id": headerClassName + index,
+ "class": headerClassName
+ }).
+
+ // Appends a top level list item HTML element to the previously created HTML header
+ append(self._nestElements($(this), index));
+
+ // Add the created unordered list element to the HTML element calling the plugin
+ self.element.append(ul);
+
+ // Finds all of the HTML tags between the header and subheader elements
+ $(this).nextUntil(this.nodeName.toLowerCase()).each(function() {
+
+ // If there are no nested subheader elemements
+ if($(this).find(self.options.selectors).length === 0) {
+
+ // Loops through all of the subheader elements
+ $(this).filter(self.options.selectors).each(function() {
+
+ //If the element matches the ignoreSelector then we skip it
+ if($(this).is(ignoreSelector)) {
+ return;
+ }
+
+ self._appendSubheaders.call(this, self, ul);
+
+ });
+
+ }
+
+ // If there are nested subheader elements
+ else {
+
+ // Loops through all of the subheader elements
+ $(this).find(self.options.selectors).each(function() {
+
+ //If the element matches the ignoreSelector then we skip it
+ if($(this).is(ignoreSelector)) {
+ return;
+ }
+
+ self._appendSubheaders.call(this, self, ul);
+
+ });
+
+ }
+
+ });
+
+ });
+
+ },
+
+ _setActiveElement: function(pageload) {
+
+ var self = this,
+
+ hash = window.location.hash.substring(1),
+
+ elem = self.element.find('li[data-unique="' + hash + '"]');
+
+ if(hash.length) {
+
+ // Removes highlighting from all of the list item's
+ self.element.find("." + self.focusClass).removeClass(self.focusClass);
+
+ // Highlights the current list item that was clicked
+ elem.addClass(self.focusClass);
+
+ // If the showAndHide option is true
+ if(self.options.showAndHide) {
+
+ // Triggers the click event on the currently focused TOC item
+ elem.click();
+
+ }
+
+ }
+
+ else {
+
+ // Removes highlighting from all of the list item's
+ self.element.find("." + self.focusClass).removeClass(self.focusClass);
+
+ if(!hash.length && pageload && self.options.highlightDefault) {
+
+ // Highlights the first TOC item if no other items are highlighted
+ self.element.find(itemClass).first().addClass(self.focusClass);
+
+ }
+
+ }
+
+ return self;
+
+ },
+
+ // _nestElements
+ // -------------
+ // Helps create the table of contents list by appending nested list items
+ _nestElements: function(self, index) {
+
+ var arr, item, hashValue;
+
+ arr = $.grep(this.items, function (item) {
+
+ return item === self.text();
+
+ });
+
+ // If there is already a duplicate TOC item
+ if(arr.length) {
+
+ // Adds the current TOC item text and index (for slight randomization) to the internal array
+ this.items.push(self.text() + index);
+
+ }
+
+ // If there not a duplicate TOC item
+ else {
+
+ // Adds the current TOC item text to the internal array
+ this.items.push(self.text());
+
+ }
+
+ hashValue = this._generateHashValue(arr, self, index);
+
+ // Appends a list item HTML element to the last unordered list HTML element found within the HTML element calling the plugin
+ item = $("<li/>", {
+
+ // Sets a common class name to the list item
+ "class": itemClassName,
+
+ "data-unique": hashValue
+
+ }).append($("<a/>", {
+
+ "text": self.text()
+
+ }));
+
+ // Adds an HTML anchor tag before the currently traversed HTML element
+ self.before($("<div/>", {
+
+ // Sets a name attribute on the anchor tag to the text of the currently traversed HTML element (also making sure that all whitespace is replaced with an underscore)
+ "name": hashValue,
+
+ "data-unique": hashValue
+
+ }));
+
+ return item;
+
+ },
+
+ // _generateHashValue
+ // ------------------
+ // Generates the hash value that will be used to refer to each item.
+ _generateHashValue: function(arr, self, index) {
+
+ var hashValue = "",
+ hashGeneratorOption = this.options.hashGenerator;
+
+ if (hashGeneratorOption === "pretty") {
+
+ // prettify the text
+ hashValue = self.text().toLowerCase().replace(/\s/g, "-");
+
+ // fix double hyphens
+ while (hashValue.indexOf("--") > -1) {
+ hashValue = hashValue.replace(/--/g, "-");
+ }
+
+ // fix colon-space instances
+ while (hashValue.indexOf(":-") > -1) {
+ hashValue = hashValue.replace(/:-/g, "-");
+ }
+
+ } else if (typeof hashGeneratorOption === "function") {
+
+ // call the function
+ hashValue = hashGeneratorOption(self.text(), self);
+
+ } else {
+
+ // compact - the default
+ hashValue = self.text().replace(/\s/g, "");
+
+ }
+
+ // add the index if we need to
+ if (arr.length) { hashValue += ""+index; }
+
+ // return the value
+ return hashValue;
+
+ },
+
+ // _appendElements
+ // ---------------
+ // Helps create the table of contents list by appending subheader elements
+
+ _appendSubheaders: function(self, ul) {
+
+ // The current element index
+ var index = $(this).index(self.options.selectors),
+
+ // Finds the previous header DOM element
+ previousHeader = $(self.options.selectors).eq(index - 1),
+
+ currentTagName = +$(this).prop("tagName").charAt(1),
+
+ previousTagName = +previousHeader.prop("tagName").charAt(1),
+
+ lastSubheader;
+
+ // If the current header DOM element is smaller than the previous header DOM element or the first subheader
+ if(currentTagName < previousTagName) {
+
+ // Selects the last unordered list HTML found within the HTML element calling the plugin
+ self.element.find(subheaderClass + "[data-tag=" + currentTagName + "]").last().append(self._nestElements($(this), index));
+
+ }
+
+ // If the current header DOM element is the same type of header(eg. h4) as the previous header DOM element
+ else if(currentTagName === previousTagName) {
+
+ ul.find(itemClass).last().after(self._nestElements($(this), index));
+
+ }
+
+ else {
+
+ // Selects the last unordered list HTML found within the HTML element calling the plugin
+ ul.find(itemClass).last().
+
+ // Appends an unorderedList HTML element to the dynamic `unorderedList` variable and sets a common class name
+ after($("<ul/>", {
+
+ "class": subheaderClassName,
+
+ "data-tag": currentTagName
+
+ })).next(subheaderClass).
+
+ // Appends a list item HTML element to the last unordered list HTML element found within the HTML element calling the plugin
+ append(self._nestElements($(this), index));
+ }
+
+ },
+
+ // _setEventHandlers
+ // ----------------
+ // Adds jQuery event handlers to the newly generated table of contents
+ _setEventHandlers: function() {
+
+ // _Local variables_
+
+ // Stores the plugin context in the self variable
+ var self = this,
+
+ // Instantiates a new variable that will be used to hold a specific element's context
+ $self,
+
+ // Instantiates a new variable that will be used to determine the smoothScroll animation time duration
+ duration;
+
+ // Event delegation that looks for any clicks on list item elements inside of the HTML element calling the plugin
+ this.element.on("click.tocify", "li", function(event) {
+
+ if(self.options.history) {
+
+ window.location.hash = $(this).attr("data-unique");
+
+ }
+
+ // Removes highlighting from all of the list item's
+ self.element.find("." + self.focusClass).removeClass(self.focusClass);
+
+ // Highlights the current list item that was clicked
+ $(this).addClass(self.focusClass);
+
+ // If the showAndHide option is true
+ if(self.options.showAndHide) {
+
+ var elem = $('li[data-unique="' + $(this).attr("data-unique") + '"]');
+
+ self._triggerShow(elem);
+
+ }
+
+ self._scrollTo($(this));
+
+ });
+
+ // Mouseenter and Mouseleave event handlers for the list item's within the HTML element calling the plugin
+ this.element.find("li").on({
+
+ // Mouseenter event handler
+ "mouseenter.tocify": function() {
+
+ // Adds a hover CSS class to the current list item
+ $(this).addClass(self.hoverClass);
+
+ // Makes sure the cursor is set to the pointer icon
+ $(this).css("cursor", "pointer");
+
+ },
+
+ // Mouseleave event handler
+ "mouseleave.tocify": function() {
+
+ if(self.options.theme !== "bootstrap") {
+
+ // Removes the hover CSS class from the current list item
+ $(this).removeClass(self.hoverClass);
+
+ }
+
+ }
+ });
+
+ // only attach handler if needed (expensive in IE)
+ if (self.options.extendPage || self.options.highlightOnScroll || self.options.scrollHistory || self.options.showAndHideOnScroll)
+ {
+ // Window scroll event handler
+ $(window).on("scroll.tocify", function() {
+
+ // Once all animations on the page are complete, this callback function will be called
+ $("html, body").promise().done(function() {
+
+ // Local variables
+
+ // Stores how far the user has scrolled
+ var winScrollTop = $(window).scrollTop(),
+
+ // Stores the height of the window
+ winHeight = $(window).height(),
+
+ // Stores the height of the document
+ docHeight = $(document).height(),
+
+ scrollHeight = $("body")[0].scrollHeight,
+
+ // Instantiates a variable that will be used to hold a selected HTML element
+ elem,
+
+ lastElem,
+
+ lastElemOffset,
+
+ currentElem;
+
+ if(self.options.extendPage) {
+
+ // If the user has scrolled to the bottom of the page and the last toc item is not focused
+ if((self.webkit && winScrollTop >= scrollHeight - winHeight - self.options.extendPageOffset) || (!self.webkit && winHeight + winScrollTop > docHeight - self.options.extendPageOffset)) {
+
+ if(!$(extendPageClass).length) {
+
+ lastElem = $('div[data-unique="' + $(itemClass).last().attr("data-unique") + '"]');
+
+ if(!lastElem.length) return;
+
+ // Gets the top offset of the page header that is linked to the last toc item
+ lastElemOffset = lastElem.offset().top;
+
+ // Appends a div to the bottom of the page and sets the height to the difference of the window scrollTop and the last element's position top offset
+ $(self.options.context).append($("<div />", {
+
+ "class": extendPageClassName,
+
+ "height": Math.abs(lastElemOffset - winScrollTop) + "px",
+
+ "data-unique": extendPageClassName
+
+ }));
+
+ if(self.extendPageScroll) {
+
+ currentElem = self.element.find('li.active');
+
+ self._scrollTo($('div[data-unique="' + currentElem.attr("data-unique") + '"]'));
+
+ }
+
+ }
+
+ }
+
+ }
+
+ // The zero timeout ensures the following code is run after the scroll events
+ setTimeout(function() {
+
+ // _Local variables_
+
+ // Stores the distance to the closest anchor
+ var closestAnchorDistance = null,
+
+ // Stores the index of the closest anchor
+ closestAnchorIdx = null,
+
+ // Keeps a reference to all anchors
+ anchors = $(self.options.context).find("div[data-unique]"),
+
+ anchorText;
+
+ // Determines the index of the closest anchor
+ anchors.each(function(idx) {
+ var distance = Math.abs(($(this).next().length ? $(this).next() : $(this)).offset().top - winScrollTop - self.options.highlightOffset);
+ if (closestAnchorDistance == null || distance < closestAnchorDistance) {
+ closestAnchorDistance = distance;
+ closestAnchorIdx = idx;
+ } else {
+ return false;
+ }
+ });
+
+ anchorText = $(anchors[closestAnchorIdx]).attr("data-unique");
+
+ // Stores the list item HTML element that corresponds to the currently traversed anchor tag
+ elem = $('li[data-unique="' + anchorText + '"]');
+
+ // If the `highlightOnScroll` option is true and a next element is found
+ if(self.options.highlightOnScroll && elem.length) {
+
+ // Removes highlighting from all of the list item's
+ self.element.find("." + self.focusClass).removeClass(self.focusClass);
+
+ // Highlights the corresponding list item
+ elem.addClass(self.focusClass);
+
+ }
+
+ if(self.options.scrollHistory) {
+
+ if(window.location.hash !== "#" + anchorText) {
+
+ window.location.replace("#" + anchorText);
+
+ }
+ }
+
+ // If the `showAndHideOnScroll` option is true
+ if(self.options.showAndHideOnScroll && self.options.showAndHide) {
+
+ self._triggerShow(elem, true);
+
+ }
+
+ }, 0);
+
+ });
+
+ });
+ }
+
+ },
+
+ // Show
+ // ----
+ // Opens the current sub-header
+ show: function(elem, scroll) {
+
+ // Stores the plugin context in the `self` variable
+ var self = this,
+ element = elem;
+
+ // If the sub-header is not already visible
+ if (!elem.is(":visible")) {
+
+ // If the current element does not have any nested subheaders, is not a header, and its parent is not visible
+ if(!elem.find(subheaderClass).length && !elem.parent().is(headerClass) && !elem.parent().is(":visible")) {
+
+ // Sets the current element to all of the subheaders within the current header
+ elem = elem.parents(subheaderClass).add(elem);
+
+ }
+
+ // If the current element does not have any nested subheaders and is not a header
+ else if(!elem.children(subheaderClass).length && !elem.parent().is(headerClass)) {
+
+ // Sets the current element to the closest subheader
+ elem = elem.closest(subheaderClass);
+
+ }
+
+ //Determines what jQuery effect to use
+ switch (self.options.showEffect) {
+
+ //Uses `no effect`
+ case "none":
+
+ elem.show();
+
+ break;
+
+ //Uses the jQuery `show` special effect
+ case "show":
+
+ elem.show(self.options.showEffectSpeed);
+
+ break;
+
+ //Uses the jQuery `slideDown` special effect
+ case "slideDown":
+
+ elem.slideDown(self.options.showEffectSpeed);
+
+ break;
+
+ //Uses the jQuery `fadeIn` special effect
+ case "fadeIn":
+
+ elem.fadeIn(self.options.showEffectSpeed);
+
+ break;
+
+ //If none of the above options were passed, then a `jQueryUI show effect` is expected
+ default:
+
+ elem.show();
+
+ break;
+
+ }
+
+ }
+
+ // If the current subheader parent element is a header
+ if(elem.parent().is(headerClass)) {
+
+ // Hides all non-active sub-headers
+ self.hide($(subheaderClass).not(elem));
+
+ }
+
+ // If the current subheader parent element is not a header
+ else {
+
+ // Hides all non-active sub-headers
+ self.hide($(subheaderClass).not(elem.closest(headerClass).find(subheaderClass).not(elem.siblings())));
+
+ }
+
+ // Maintains chainablity
+ return self;
+
+ },
+
+ // Hide
+ // ----
+ // Closes the current sub-header
+ hide: function(elem) {
+
+ // Stores the plugin context in the `self` variable
+ var self = this;
+
+ //Determines what jQuery effect to use
+ switch (self.options.hideEffect) {
+
+ // Uses `no effect`
+ case "none":
+
+ elem.hide();
+
+ break;
+
+ // Uses the jQuery `hide` special effect
+ case "hide":
+
+ elem.hide(self.options.hideEffectSpeed);
+
+ break;
+
+ // Uses the jQuery `slideUp` special effect
+ case "slideUp":
+
+ elem.slideUp(self.options.hideEffectSpeed);
+
+ break;
+
+ // Uses the jQuery `fadeOut` special effect
+ case "fadeOut":
+
+ elem.fadeOut(self.options.hideEffectSpeed);
+
+ break;
+
+ // If none of the above options were passed, then a `jqueryUI hide effect` is expected
+ default:
+
+ elem.hide();
+
+ break;
+
+ }
+
+ // Maintains chainablity
+ return self;
+ },
+
+ // _triggerShow
+ // ------------
+ // Determines what elements get shown on scroll and click
+ _triggerShow: function(elem, scroll) {
+
+ var self = this;
+
+ // If the current element's parent is a header element or the next element is a nested subheader element
+ if(elem.parent().is(headerClass) || elem.next().is(subheaderClass)) {
+
+ // Shows the next sub-header element
+ self.show(elem.next(subheaderClass), scroll);
+
+ }
+
+ // If the current element's parent is a subheader element
+ else if(elem.parent().is(subheaderClass)) {
+
+ // Shows the parent sub-header element
+ self.show(elem.parent(), scroll);
+
+ }
+
+ // Maintains chainability
+ return self;
+
+ },
+
+ // _addCSSClasses
+ // --------------
+ // Adds CSS classes to the newly generated table of contents HTML
+ _addCSSClasses: function() {
+
+ // If the user wants a jqueryUI theme
+ if(this.options.theme === "jqueryui") {
+
+ this.focusClass = "ui-state-default";
+
+ this.hoverClass = "ui-state-hover";
+
+ //Adds the default styling to the dropdown list
+ this.element.addClass("ui-widget").find(".toc-title").addClass("ui-widget-header").end().find("li").addClass("ui-widget-content");
+
+ }
+
+ // If the user wants a twitterBootstrap theme
+ else if(this.options.theme === "bootstrap") {
+
+ this.element.find(headerClass + "," + subheaderClass).addClass("nav nav-list");
+
+ this.focusClass = "active";
+
+ }
+
+ // If a user does not want a prebuilt theme
+ else {
+
+ // Adds more neutral classes (instead of jqueryui)
+
+ this.focusClass = tocFocusClassName;
+
+ this.hoverClass = tocHoverClassName;
+
+ }
+
+ //Maintains chainability
+ return this;
+
+ },
+
+ // setOption
+ // ---------
+ // Sets a single Tocify option after the plugin is invoked
+ setOption: function() {
+
+ // Calls the jQueryUI Widget Factory setOption method
+ $.Widget.prototype._setOption.apply(this, arguments);
+
+ },
+
+ // setOptions
+ // ----------
+ // Sets a single or multiple Tocify options after the plugin is invoked
+ setOptions: function() {
+
+ // Calls the jQueryUI Widget Factory setOptions method
+ $.Widget.prototype._setOptions.apply(this, arguments);
+
+ },
+
+ // _scrollTo
+ // ---------
+ // Scrolls to a specific element
+ _scrollTo: function(elem) {
+
+ var self = this,
+ duration = self.options.smoothScroll || 0,
+ scrollTo = self.options.scrollTo,
+ currentDiv = $('div[data-unique="' + elem.attr("data-unique") + '"]');
+
+ if(!currentDiv.length) {
+
+ return self;
+
+ }
+
+ // Once all animations on the page are complete, this callback function will be called
+ $("html, body").promise().done(function() {
+
+ // Animates the html and body element scrolltops
+ $("html, body").animate({
+
+ // Sets the jQuery `scrollTop` to the top offset of the HTML div tag that matches the current list item's `data-unique` tag
+ "scrollTop": currentDiv.offset().top - ($.isFunction(scrollTo) ? scrollTo.call() : scrollTo) + "px"
+
+ }, {
+
+ // Sets the smoothScroll animation time duration to the smoothScrollSpeed option
+ "duration": duration
+
+ });
+
+ });
+
+ // Maintains chainability
+ return self;
+
+ }
+
+ });
+
+})); //end of plugin
[6/6] isis git commit: ISIS-1152: allow lazy registration of event
bus subscribers.
Posted by da...@apache.org.
ISIS-1152: allow lazy registration of event bus subscribers.
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/ec058a8d
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/ec058a8d
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/ec058a8d
Branch: refs/heads/master
Commit: ec058a8deace942ea555fa6cc1f7bea23dfa8009
Parents: b05b63e
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Fri May 15 19:18:52 2015 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Fri May 15 19:18:52 2015 +0100
----------------------------------------------------------------------
.../services/eventbus/EventBusService.java | 6 +++++-
.../eventbus/EventBusServiceDefault.java | 19 ++++++++++++-------
.../IsisConfigurationForJdoIntegTests.java | 2 ++
3 files changed, 19 insertions(+), 8 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/ec058a8d/core/applib/src/main/java/org/apache/isis/applib/services/eventbus/EventBusService.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/eventbus/EventBusService.java b/core/applib/src/main/java/org/apache/isis/applib/services/eventbus/EventBusService.java
index a4ac8eb..37b049d 100644
--- a/core/applib/src/main/java/org/apache/isis/applib/services/eventbus/EventBusService.java
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/eventbus/EventBusService.java
@@ -156,7 +156,11 @@ public abstract class EventBusService {
* need to.
*/
protected void doRegister(Object domainService) {
- subscribers.add(domainService);
+ if(eventBusImplementation == null) {
+ subscribers.add(domainService);
+ } else {
+ eventBusImplementation.register(domainService);
+ }
}
/**
http://git-wip-us.apache.org/repos/asf/isis/blob/ec058a8d/core/runtime/src/main/java/org/apache/isis/core/runtime/services/eventbus/EventBusServiceDefault.java
----------------------------------------------------------------------
diff --git a/core/runtime/src/main/java/org/apache/isis/core/runtime/services/eventbus/EventBusServiceDefault.java b/core/runtime/src/main/java/org/apache/isis/core/runtime/services/eventbus/EventBusServiceDefault.java
index 33b0097..e3437db 100644
--- a/core/runtime/src/main/java/org/apache/isis/core/runtime/services/eventbus/EventBusServiceDefault.java
+++ b/core/runtime/src/main/java/org/apache/isis/core/runtime/services/eventbus/EventBusServiceDefault.java
@@ -34,7 +34,8 @@ import org.apache.isis.core.runtime.services.eventbus.adapter.EventBusImplementa
* Holds common runtime logic for EventBusService implementations.
*/
public abstract class EventBusServiceDefault extends EventBusService {
-
+
+
//region > register
/**
* {@inheritDoc}
@@ -58,7 +59,7 @@ public abstract class EventBusServiceDefault extends EventBusService {
throw new IllegalArgumentException("Request-scoped services must register their proxy, not themselves");
}
// a singleton
- if(this.eventBusImplementation != null) {
+ if (!allowLateRegistration && this.eventBusImplementation != null) {
// ... coming too late to the party.
throw new IllegalStateException("Event bus has already been created; too late to register any further (singleton) subscribers");
}
@@ -72,19 +73,23 @@ public abstract class EventBusServiceDefault extends EventBusService {
@Programmatic
@PostConstruct
public void init(final Map<String, String> properties) {
- final String implementation = properties.get("isis.services.eventbus.implementation");
+ final String allowLateRegistrationStr = properties.get("isis.services.eventbus.allowLateRegistration");
+ this.allowLateRegistration = !Strings.isNullOrEmpty(allowLateRegistrationStr) && Boolean.parseBoolean(allowLateRegistrationStr);
+
+ final String implementation = properties.get("isis.services.eventbus.implementation");
if(Strings.isNullOrEmpty(implementation) || "guava".equalsIgnoreCase(implementation)) {
this.implementation = "guava";
- return;
- }
- if("axon".equalsIgnoreCase(implementation)) {
+ } else if("axon".equalsIgnoreCase(implementation)) {
this.implementation = "axon";
+ } else {
+ this.implementation = implementation;
}
- this.implementation = implementation;
}
//endregion
+ private boolean allowLateRegistration;
+
/**
* Either <guava> or <axon>, or else the fully qualified class name of an
* implementation of {@link org.apache.isis.applib.services.eventbus.EventBusImplementation}.
http://git-wip-us.apache.org/repos/asf/isis/blob/ec058a8d/core/runtime/src/main/java/org/apache/isis/objectstore/jdo/datanucleus/IsisConfigurationForJdoIntegTests.java
----------------------------------------------------------------------
diff --git a/core/runtime/src/main/java/org/apache/isis/objectstore/jdo/datanucleus/IsisConfigurationForJdoIntegTests.java b/core/runtime/src/main/java/org/apache/isis/objectstore/jdo/datanucleus/IsisConfigurationForJdoIntegTests.java
index 26f4b0d..535d9af 100644
--- a/core/runtime/src/main/java/org/apache/isis/objectstore/jdo/datanucleus/IsisConfigurationForJdoIntegTests.java
+++ b/core/runtime/src/main/java/org/apache/isis/objectstore/jdo/datanucleus/IsisConfigurationForJdoIntegTests.java
@@ -84,6 +84,8 @@ public class IsisConfigurationForJdoIntegTests extends IsisConfigurationDefault
add(PersistenceConstants.ENFORCE_SAFE_SEMANTICS, ""+PersistenceConstants.ENFORCE_SAFE_SEMANTICS_DEFAULT);
add("isis.deploymentType", "server_prototype");
+
+ add("isis.services.eventbus.allowLateRegistration", "true");
}
public final IsisConfigurationForJdoIntegTests addDataNucleusProperty(final String key, final String value) {
[3/6] isis git commit: ISIS-1133: styling of tocify,
and downloading its css and js dependencies so can run offline.
Posted by da...@apache.org.
http://git-wip-us.apache.org/repos/asf/isis/blob/b05b63e4/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_wrapper-factory.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_wrapper-factory.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_wrapper-factory.adoc
index 75e9d25..e2949b1 100644
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_wrapper-factory.adoc
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_wrapper-factory.adoc
@@ -6,3 +6,13 @@
IMPORTANT: TODO
+
+
+
+
+
+== `wrapNoExecute()`
+
+
+== `wrapSkipRules()`
+
http://git-wip-us.apache.org/repos/asf/isis/blob/b05b63e4/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_testing_integ-test-support_wrapper-factory.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_testing_integ-test-support_wrapper-factory.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_testing_integ-test-support_wrapper-factory.adoc
index 223d6d9..61fef93 100644
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_testing_integ-test-support_wrapper-factory.adoc
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_testing_integ-test-support_wrapper-factory.adoc
@@ -36,6 +36,7 @@ Let's look in a bit more detail at what the test can do with the wrapper.
+
== Wrapping and Unwrapping
Wrapping a domain object is very straightforward; simply call `WrapperFactory#wrap(...)`.
@@ -121,52 +122,40 @@ then invoking the action through the proxy will cause the event (`CompletedEvent
[source,java]
----
@Inject
-private EventBusService eventBusService;
+private EventBusService eventBusService; // <1>
@Test
public void subscriberReceivesEvents() throws Exception {
+
// given
- final ToDoItem.CompletedEvent[] evHolder = new ToDoItem.CompletedEvent[1];
+ final ToDoItem.CompletedEvent[] evHolder = new ToDoItem.CompletedEvent[1]; // <2>
eventBusService.register(new Object() {
@Subscribe
- public void on(final ToDoItem.CompletedEvent ev) {
+ public void on(final ToDoItem.CompletedEvent ev) { // <3>
evHolder[0] = ev;
}
});
// when
- toDoItem.completed();
+ toDoItem.completed(); // <4>
// then
- then(evHolder[0].getSource()).isEqualTo(unwrap(toDoItem));
+ then(evHolder[0].getSource()).isEqualTo(unwrap(toDoItem)); // <5>
then(evHolder[0].getIdentifier().getMemberName()).isEqualTo("completed");
}
----
-
+<1> inject <<__code_EventBusService_code, `EventBusService`>> into this test
+<2> holder for subscriber to capture event to
+<3> subscriber's callback, using the guava subscriber syntax
+<4> invoking the domain object using the wrapper
+<5> assert that the event was populated
The wrapper will also fire domain events for properties (if annotated with `@Property(domainEvent=...)`) or collections (if annotated with `@Collection(domainEvent=...)`).
-
[NOTE]
====
It isn't possible to use the `WrapperFactory` in a unit test, because there needs to be a running instance of Isis that holds the metamodel.
====
-
-
-
-
-[NOTE]
-====
-The `WrapperFactory` service also provides a numer of overloads of the `wrap()` method:
-
-* `wrapNoExecute(...)` will check the business rules but suppresses the actual execution
-* `wrapSkipRules(...)` does the opposite: skip business rules but executing the action.
-
-We mention them only to say that these two methods are not of particular significance for integration tests, however they are useful when domain objects in one module need to interact (in a decoupled fashion) with domain objects in some other module.
-
-For more details, see <<_wrapper_factory, Wrapper Factory>> service.
-====
-
http://git-wip-us.apache.org/repos/asf/isis/blob/b05b63e4/adocs/documentation/src/main/asciidoc/user-guide/user-guide.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide.adoc
index 7107ee1..35ea60c 100644
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide.adoc
+++ b/adocs/documentation/src/main/asciidoc/user-guide/user-guide.adoc
@@ -4,19 +4,19 @@
:_imagesdir: images/
:numbered:
-//include::_user-guide_core-concepts.adoc[leveloffset=+1]
-//include::_user-guide_getting-started.adoc[leveloffset=+1]
-//include::_user-guide_how-tos.adoc[leveloffset=+1]
-//include::_user-guide_more-advanced.adoc[leveloffset=+1]
+include::_user-guide_core-concepts.adoc[leveloffset=+1]
+include::_user-guide_getting-started.adoc[leveloffset=+1]
+include::_user-guide_how-tos.adoc[leveloffset=+1]
+include::_user-guide_more-advanced.adoc[leveloffset=+1]
include::_user-guide_reference.adoc[leveloffset=+1]
-//include::_user-guide_wicket-viewer.adoc[leveloffset=+1]
-//include::_user-guide_restfulobjects-viewer.adoc[leveloffset=+1]
-//include::_user-guide_security.adoc[leveloffset=+1]
+include::_user-guide_wicket-viewer.adoc[leveloffset=+1]
+include::_user-guide_restfulobjects-viewer.adoc[leveloffset=+1]
+include::_user-guide_security.adoc[leveloffset=+1]
include::_user-guide_runtime.adoc[leveloffset=+1]
-//include::_user-guide_deployment.adoc[leveloffset=+1]
+include::_user-guide_deployment.adoc[leveloffset=+1]
include::_user-guide_testing.adoc[leveloffset=+1]
-//include::_user-guide_headless-access.adoc[leveloffset=+1]
-//include::_user-guide_isis-addons-modules.adoc[leveloffset=+1]
-//include::_user-guide_extending.adoc[leveloffset=+1]
-//include::_user-guide_troubleshooting.adoc[leveloffset=+1]
-//include::_user-guide_appendices.adoc[leveloffset=+1]
+include::_user-guide_headless-access.adoc[leveloffset=+1]
+include::_user-guide_isis-addons-modules.adoc[leveloffset=+1]
+include::_user-guide_extending.adoc[leveloffset=+1]
+include::_user-guide_troubleshooting.adoc[leveloffset=+1]
+include::_user-guide_appendices.adoc[leveloffset=+1]
http://git-wip-us.apache.org/repos/asf/isis/blob/b05b63e4/adocs/template/document.html.erb
----------------------------------------------------------------------
diff --git a/adocs/template/document.html.erb b/adocs/template/document.html.erb
index f726158..3416629 100644
--- a/adocs/template/document.html.erb
+++ b/adocs/template/document.html.erb
@@ -30,16 +30,22 @@
<meta http-equiv="pragma" content="no-cache" />
<meta http-equiv="expires" content="-1" />
+
+ <-- TODO: need to (re)instate CDN in the future (not using for now just so can develop off-line -->
<link href="<%= (attr :_basedir) %>css/foundation/5.5.1/foundation.css" rel="stylesheet" />
<script src="<%= (attr :_basedir) %>js/foundation/5.5.1/vendor/modernizr.js"></script>
<link href="<%= (attr :_basedir) %>css/asciidoctor/colony.css" rel="stylesheet">
<link href="<%= (attr :_basedir) %>css/font-awesome/4.3.0/css/font-awesome.min.css" rel="stylesheet">
+
+
+
<link href="<%= (attr :_basedir) %>css/github-fork-ribbon-css/0.1.1/gh-fork-ribbon.css" rel="stylesheet" />
<!--[if lt IE 9]>
<link href="<%= (attr :_basedir) %>css/github-fork-ribbon-css/0.1.1/gh-fork-ribbon.ie.css" rel="stylesheet" />
<![endif]-->
+
<style type="text/css">
<%= ::Asciidoctor::Stylesheets.instance.coderay_stylesheet_data %>
@@ -170,11 +176,15 @@
<style>
+ body div#toc .tocify-subheader ul {
+ margin-bottom: 0px;
+ }
+
body div#toc .tocify-subheader li {
font-size: 14px;
}
- body div#toc .tocify li, .tocify ul {
- line-height: 20px;
+ .tocify li.tocify-item, .tocify ul.tocify-item {
+ line-height: 24px;
}
body div#toc li.tocify-item.active:before,
@@ -287,11 +297,14 @@
*/
.header--hidden
{
- /*
-webkit-transform: translateY( -100% );
-ms-transform: translateY( -100% );
transform: translateY( -100% );
- */
+
+ transition-duration: .5s;
+ transition-timing-function: cubic-bezier( 0.215, 0.610, 0.355, 1.000 );
+ -webkit-transition-property: -webkit-transform;
+ transition-property: transform;
}
</style>
@@ -442,11 +455,10 @@
<script src="<%= (attr :_basedir) %>js/foundation/5.5.1/foundation.min.js"></script>
-<!-- Tocify - nice dynamic autoscrolling TOC -->
-<link href="https://cdnjs.cloudflare.com/ajax/libs/jquery.tocify/1.9.0/stylesheets/jquery.tocify.min.css" rel="stylesheet">
-<script src="https://code.jquery.com/jquery-1.11.3.min.js"></script>
-<script src="https://cdnjs.cloudflare.com/ajax/libs/jqueryui/1.11.4/jquery-ui.min.js"></script>
-<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery.tocify/1.9.0/javascripts/jquery.tocify.min.js"></script>
+<link href="<%= (attr :_basedir) %>css/jquery.tocify/1.9.0/jquery.tocify.css" rel="stylesheet">
+<script src="<%= (attr :_basedir) %>js/jqueryui/1.11.4/jquery-ui.min.js"></script> -->
+<script src="<%= (attr :_basedir) %>js/jquery.tocify/1.9.0/jquery.tocify.js"></script>
+
<script type="text/javascript">
[2/6] isis git commit: ISIS-1133: adocs ... break out services into
API vs SPI; using tocify; a bit more on testing.
Posted by da...@apache.org.
ISIS-1133: adocs ... break out services into API vs SPI; using tocify; a bit more on testing.
thanks Deltaspike for finding tocify... works nicely!
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/4d0478a8
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/4d0478a8
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/4d0478a8
Branch: refs/heads/master
Commit: 4d0478a85e55b18d8d02c59edf2d80443f4357a2
Parents: 65d34db
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Fri May 15 18:23:47 2015 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Fri May 15 18:23:47 2015 +0100
----------------------------------------------------------------------
.../user-guide/_user-guide_reference.adoc | 12 +-
...uide_reference_convenience-superclasses.adoc | 8 -
.../_user-guide_reference_methods_aaa.adoc | 27 +-
.../_user-guide_reference_services-api.adoc | 30 ++
.../_user-guide_reference_services-api_aaa.adoc | 215 ++++++++++
..._services-api_action-invocation-context.adoc | 8 +
...ference_services-api_background-service.adoc | 8 +
...reference_services-api_bookmark-service.adoc | 8 +
...de_reference_services-api_clock-service.adoc | 8 +
..._reference_services-api_command-context.adoc | 8 +
...eference_services-api_deep-link-service.adoc | 8 +
...ce_services-api_domain-object-container.adoc | 8 +
...de_reference_services-api_email-service.adoc | 8 +
...eference_services-api_event-bus-service.adoc | 15 +
...erence_services-api_guice-bean-provider.adoc | 8 +
...reference_services-api_isis-jdo-support.adoc | 129 ++++++
..._reference_services-api_memento-service.adoc | 8 +
...eference_services-api_metamodel-service.adoc | 8 +
...erence_services-api_query-results-cache.adoc | 8 +
...uide_reference_services-api_scratch-pad.adoc | 8 +
...ide_reference_services-api_sudo-service.adoc | 8 +
..._reference_services-api_wrapper-factory.adoc | 8 +
...rence_services-api_xml-snapshot-service.adoc | 8 +
.../_user-guide_reference_services-spi.adoc | 25 ++
.../_user-guide_reference_services-spi_aaa.adoc | 214 ++++++++++
...reference_services-spi_auditing-service.adoc | 13 +
...services-spi_background-command-service.adoc | 12 +
...ce_services-spi_class-discovery-service.adoc | 8 +
..._reference_services-spi_command-service.adoc | 11 +
...ce_services-spi_content-mapping-service.adoc | 8 +
...ervices-spi_content-negotiation-service.adoc | 8 +
...services-spi_email-notification-service.adoc | 8 +
...reference_services-spi_event-serializer.adoc | 8 +
...rence_services-spi_exception-recognizer.adoc | 8 +
..._reference_services-spi_locale-provider.adoc | 8 +
...ference_services-spi_publishing-service.adoc | 11 +
...erence_services-spi_translation-service.adoc | 8 +
...ence_services-spi_translations-resolver.adoc | 8 +
...rence_services-spi_user-profile-service.adoc | 8 +
..._services-spi_user-registration-service.adoc | 8 +
.../_user-guide_reference_services.adoc | 45 ---
.../_user-guide_reference_services_aaa.adoc | 403 -------------------
...ence_services_action-invocation-context.adoc | 8 -
...ide_reference_services_auditing-service.adoc | 13 -
...nce_services_background-command-service.adoc | 12 -
...e_reference_services_background-service.adoc | 8 -
...ide_reference_services_bookmark-service.adoc | 8 -
...erence_services_class-discovery-service.adoc | 8 -
...-guide_reference_services_clock-service.adoc | 8 -
...uide_reference_services_command-context.adoc | 8 -
...uide_reference_services_command-service.adoc | 11 -
...erence_services_content-mapping-service.adoc | 8 -
...ce_services_content-negotiation-service.adoc | 8 -
...de_reference_services_deep-link-service.adoc | 8 -
...erence_services_domain-object-container.adoc | 8 -
...nce_services_email-notification-service.adoc | 8 -
...-guide_reference_services_email-service.adoc | 8 -
...de_reference_services_event-bus-service.adoc | 15 -
...ide_reference_services_event-serializer.adoc | 8 -
...reference_services_exception-recognizer.adoc | 8 -
...uide_reference_services_fixture-scripts.adoc | 8 -
..._reference_services_guice-bean-provider.adoc | 8 -
...ide_reference_services_isis-jdo-support.adoc | 129 ------
...uide_reference_services_locale-provider.adoc | 8 -
...uide_reference_services_memento-service.adoc | 8 -
...de_reference_services_metamodel-service.adoc | 8 -
...e_reference_services_publishing-service.adoc | 11 -
..._reference_services_query-results-cache.adoc | 8 -
...er-guide_reference_services_scratch-pad.adoc | 8 -
...r-guide_reference_services_sudo-service.adoc | 8 -
..._reference_services_translation-service.adoc | 8 -
...eference_services_translations-resolver.adoc | 8 -
...reference_services_user-profile-service.adoc | 8 -
...ence_services_user-registration-service.adoc | 8 -
...uide_reference_services_wrapper-factory.adoc | 8 -
...reference_services_xml-snapshot-service.adoc | 8 -
.../_user-guide_reference_superclasses.adoc | 52 +++
..._reference_superclasses_fixture-scripts.adoc | 8 +
...ting_integ-test-support_wrapper-factory.adoc | 106 ++++-
adocs/template/document.html.erb | 62 ++-
80 files changed, 1118 insertions(+), 911 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference.adoc
index c4a4adc..62324ed 100644
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference.adoc
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference.adoc
@@ -5,13 +5,21 @@
IMPORTANT: TODO
+Apache Isis includes an extensive number of domain services for your domain objects to use; simply define the service as an annotated field and Isis will inject the service into your object. These services' API are all defined in Isis' applib (`o.a.i.core:isis-core-applib` module); this minimizes the coupling between your code and Isis. It also allows you to easily mock out these services in your unit tests.
+
+Some of the services defined in the applib are intended to be used (primarily) not by your domain objects but instead by Isis itself. A good example of this is the <<__code_auditingservice3_code, `AuditingService3`>> service; if an implementation is present then Isis will call that service in order to record audit log entries. If no implementation is available then Isis will carry on regardless.
+
+Some domain services can be considered both API and SPI; a good example is the `EmailService` that is of direct use for domain objects wishing to send out emails, but is also used by the framework to support the user registration functionality supported by the <<_wicket_viewer, Wicket viewer>>. The same is true of the <<__code_eventbusservice_code, `EventBusService`>>; this can be used by domain objects to broadcast arbitrary events, but is also used by the framework to automatically emit events eg for `@Action(domainEvent=...)`. For these hybrid services we we have categorized the service as an "API" service.
+
+
include::_user-guide_reference_annotations.adoc[leveloffset=+1]
include::_user-guide_reference_prefixes.adoc[leveloffset=+1]
include::_user-guide_reference_methods.adoc[leveloffset=+1]
-include::_user-guide_reference_services.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi.adoc[leveloffset=+1]
+include::_user-guide_reference_superclasses.adoc[leveloffset=+1]
include::_user-guide_reference_value-types.adoc[leveloffset=+1]
include::_user-guide_reference_applib-utility-classes.adoc[leveloffset=+1]
-include::_user-guide_reference_convenience-superclasses.adoc[leveloffset=+1]
include::_user-guide_reference_mixins.adoc[leveloffset=+1]
include::_user-guide_reference_addons.adoc[leveloffset=+1]
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_convenience-superclasses.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_convenience-superclasses.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_convenience-superclasses.adoc
deleted file mode 100644
index 5a8e956..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_convenience-superclasses.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= Convenience Superclasses
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_aaa.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_aaa.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_aaa.adoc
index ff6d049..7c83936 100644
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_aaa.adoc
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_aaa.adoc
@@ -15,30 +15,23 @@ The table below lists the reserved methods that are recognized as part of Apache
|Method
|Description
-|<<__code_cssClass_code, `cssClass()`>>
+|<<__code_cssclass_code, `cssClass()`>>
|Provides a CSS class for this object, which is added as a style in the containing when rendering the object within a table, or to a containing when rendering the object on a page. In conjunction with css/application.css, can therefore provide custom styling of an object instance wherever it is rendered.
See also <<__code_title_code, `title()`>> and <<__code_iconName_code, `iconName()`>>.
-|<<__code_iconName_code, `iconName()`>>
+|<<__code_iconname_code, `iconName()`>>
|Provides the name of the image to render, usually alongside the title, to represent the object. If not provided, then the class name is used to locate an image.
See also <<__code_title_code, `title()`>> and <<__code_cssClass_code, `cssClass()`>>
-|<<__code_getId_code, `getId()`>>
-|Y
+|<<__code_getid_code, `getId()`>>
|Provides an optional unique identifier of a service. +
If not provided, the services fully-qualified class name is used.
|<<__code_title_code, `title()`>>
-|Y
|Provides a title for the object. +
-Alternatively, use the <<__code_title_code, <<__code_@Title`>> annotation. It is also possible to use `toString_code, `@Title`>> annotation. It is also possible to use `toString()`>>. +
+Alternatively, use the <<__code_title_code, `@Title`>> annotation. +
See also `iconName()` and <<__code_cssClass_code, `cssClass()`>>
-|<<__code_toString_code, `toString()`>>
-|Y
-|Used as the fallback title for an object if there is no <<__code_title_code, `title()`>> method or properties annotated with the <<__code_title_code, `@Title`>> annotation.
-
-
|===
@@ -100,25 +93,23 @@ Some lifecycle methods have been deprecated:
|Method
|Notes
-|<<__code_deleted_code, `deleted()`>>
+|`deleted()`
|Replaced by <<__code_removed_code, `removed()`>>
-|<<__code_deleting_code, `deleting()`>>
+|`deleting()`
|Replaced by removing()`
-|`loading`
+|`loading()`
|callback for when the (persistent) object is just about to be loaded from the object store. +
[WARNING]
====
This method is never called.
====
-|<<__code_saved_code, `saved()`>>
-|Y
+|`saved()`
|Replaced by persisted()`
-|<<__code_saving_code, `saving()`>>
-|Y
+|`saving()`
|Replaced by <<__code_persisting_code, `persisting()`>>
|===
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api.adoc
new file mode 100644
index 0000000..f613063
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api.adoc
@@ -0,0 +1,30 @@
+= Domain Services (API)
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+
+IMPORTANT: TODO
+
+include::_user-guide_reference_services-api_aaa.adoc[leveloffset=+1]
+
+include::_user-guide_reference_services-api_action-invocation-context.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_background-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_bookmark-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_clock-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_command-context.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_deep-link-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_domain-object-container.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_email-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_event-bus-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_guice-bean-provider.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_isis-jdo-support.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_memento-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_metamodel-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_query-results-cache.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_scratch-pad.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_sudo-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_wrapper-factory.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_xml-snapshot-service.adoc[leveloffset=+1]
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_aaa.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_aaa.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_aaa.adoc
new file mode 100644
index 0000000..4bb02a9
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_aaa.adoc
@@ -0,0 +1,215 @@
+= Summary
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+
+
+IMPORTANT: TODO
+
+
+== Applib Services
+
+The table below summarizes all the APIs defined by Apache Isis. It also lists their corresponding implementation, either a default implementation provided by Isis itself, or provided by one of the in http://isisaddons.org[Isis Addons] (non-ASF)modules.
+
+.Domain Services
+[cols="2,4a,1,1", options="header"]
+|===
+
+|API
+|Maven Module +
+Impl'n (g: a:)
+|Implementation
+|Notes
+
+|<<__code_actioninvocationcontext_code, `o.a.i.applib.` +
+`services.actinv` +
+`ActionInvocation-` +
+`Context`>>
+|``o.a.i.core`` +
+``isis-core-applib``
+|`ActionInvocationContext`
+|API is also concrete class
+
+|<<__code_backgroundservice_code, `o.a.i.applib.` +
+`services.background` +
+`BackgroundService`>>
+|``o.a.i.core`` +
+``isis-core-runtime``
+|`BackgroundServiceDefault`
+|depends on: +
+`BackgroundCommandService`
+
+|<<__code_bookmarkservice_code, `o.a.i.applib.` +
+`services.bookmark` +
+`BookmarkService`>>
+|``o.a.i.core`` +
+``isis-core-metamodel``
+|`BookmarkServiceDefault`
+|related services:
+`BookmarkHolder-` ++
+`ActionContributions`,
+`BookmarkHolder-` ++
+`AssociationContributions`
+
+|<<__code_clockservice_code, `o.a.i.applib.` +
+`services.clock` +
+`ClockService`>>
+|``o.a.i.core`` +
+``isis-core-applib``
+|`ClockService`
+|API is also a concrete class.
+
+|<<__code_commandcontext_code, `o.a.i.applib.` +
+`services.command` +
+`CommandContext`>>
+|``o.a.i.core`` +
+``isis-core-applib``
+|`CommandContext`
+|API is also a concrete class. +
+depends on: +
+`CommandService` for persistent `Command`, else in-memory impl. used
+
+|<<__code_deeplinkservice_code, `o.a.i.applib` +
+`services.deeplink` +
+`DeepLinkService`>>
+|``o.a.i.viewer`` +
+``isis-viewer-wicket-impl``
+|`DeepLinkServiceWicket`
+|Implementation only usable within Wicket viewer
+
+|<<__code_domainobjectcontainer_code, `o.a.i.applib` +
+`DomainObjectContainer`>>
+|``o.a.i.core`` +
+``isis-core-metamodel``
+|`DomainObjectContainerDefault`
+|
+
+|<<__code_emailservice_code, `o.a.i.applib.` +
+`services.email` +
+`EmailService`>>
+|``o.a.i.core`` +
+``isis-core-runtime``
+|`EmailServiceDefault`
+|
+
+|<<__code_eventbusservice_code, `o.a.i.applib.` +
+`services.eventbus` +
+`EventBusService`>>
+|``o.a.i.core`` +
+``isis-core-objectstore-jdo-datanucleus``
+|`EventBusServiceJdo`
+|
+
+|<<__code_guicebeanprovider_code, `o.a.i.applib.` +
+`services.guice` +
+`GuiceBeanProvider`>>
+|``o.a.i.core`` +
+``isis-viewer-wicket-impl``
+|`GuiceBeanProviderWicket`
+|
+
+|<<__code_isisjdosupport_code, `o.a.i.applib.` +
+`services.jdosupport` +
+`IsisJdoSupport`>>
+|``o.a.i.core`` +
+``isis-core-objectstore-jdo-datanucleus``
+|`IsisJdoSupportImpl`
+|
+
+|<<__code_mementoservice_code, `o.a.i.applib.` +
+`services.memento` +
+`MementoService`>>
+|``o.a.i.core`` +
+``isis-core-runtime``
+|`MementoServiceDefault`
+|
+
+|<<__code_metamodelservice_code, `o.a.i.applib.` +
+`services.metamodel` +
+`MetaModelService`>>
+|``o.a.i.core`` +
+``isis-core-metamodel``
+|`MetaModelServiceDefault`
+|
+
+|<<__code_queryresultscache_code, `o.a.i.applib.` +
+`services.` +
+`queryresultscache` +
+`QueryResultsCache`>>
+|``o.a.i.core`` +
+``isis-core-applib``
+|`QueryResultsCache`
+|API is also a concrete class
+
+|<<__code_scratchpad_code, `o.a.i.applib.` +
+`services.scratchpad` +
+`Scratchpad`>>
+|``o.a.i.core`` +
+``isis-core-applib``
+|`Scratchpad`
+|API is also a concrete class
+
+|<<__code_scratchpad_code, `o.a.i.applib.` +
+`services.sudo` +
+`SudoService`>>
+|``o.a.i.core`` +
+``isis-core-runtime``
+|`SudoServiceDefault`
+|API is also a concrete class
+
+|<<__code_wrapperfactory_code, `o.a.i.applib.` +
+`services.wrapper` +
+`WrapperFactory`>>
+|``o.a.i.core`` +
+``isis-core-wrapper``
+|`WrapperFactoryDefault`
+|
+
+|<<__code_xmlsnapshotservice_code, `o.a.i.applib.` +
+`services.xmlsnapshot` +
+`XmlSnapshotService`>>
+|``o.a.i.core`` +
+``isis-core-runtime``
+|`XmlSnapshotServiceDefault`
+|
+
+|===
+
+Key:
+
+* `o.a.i` is an abbreviation for `org.apache.isis`
+* `o.ia.m` is an abbreviation for `org.isisaddons.module`
+
+
+
+
+== Deprecated Services
+
+There is also a number of deprecated domain services.
+
+.Deprecated Domain Services
+[cols="2,4a,1,1", options="header"]
+|===
+
+|API
+|Maven Module +
+Impl'n (g: a:)
+|Implementation
+|Notes
+
+|`o.a.i.applib.` +
+`annotation`
+`Bulk.InteractionContext`
+|``o.a.i.core`` +
+``isis-core-applib``
+|`Bulk.InteractionContext`
+|Replaced by `ActionInvocationContext`
+
+
+|===
+
+Key:
+
+* `o.a.i` is an abbreviation for `org.apache.isis`
+* `o.ia.m` is an abbreviation for `org.isisaddons.module`
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_action-invocation-context.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_action-invocation-context.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_action-invocation-context.adoc
new file mode 100644
index 0000000..989d131
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_action-invocation-context.adoc
@@ -0,0 +1,8 @@
+= `ActionInvocationContext`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_background-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_background-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_background-service.adoc
new file mode 100644
index 0000000..74c69e5
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_background-service.adoc
@@ -0,0 +1,8 @@
+= `BackgroundService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_bookmark-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_bookmark-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_bookmark-service.adoc
new file mode 100644
index 0000000..5d0024a
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_bookmark-service.adoc
@@ -0,0 +1,8 @@
+= `BookmarkService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_clock-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_clock-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_clock-service.adoc
new file mode 100644
index 0000000..1b4675d
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_clock-service.adoc
@@ -0,0 +1,8 @@
+= `ClockService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_command-context.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_command-context.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_command-context.adoc
new file mode 100644
index 0000000..15c250c
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_command-context.adoc
@@ -0,0 +1,8 @@
+= `CommandContext`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_deep-link-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_deep-link-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_deep-link-service.adoc
new file mode 100644
index 0000000..7135b31
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_deep-link-service.adoc
@@ -0,0 +1,8 @@
+= `DeepLinkService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_domain-object-container.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_domain-object-container.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_domain-object-container.adoc
new file mode 100644
index 0000000..53d253f
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_domain-object-container.adoc
@@ -0,0 +1,8 @@
+= `DomainObjectContainer`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_email-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_email-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_email-service.adoc
new file mode 100644
index 0000000..6f78302
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_email-service.adoc
@@ -0,0 +1,8 @@
+= `EmailService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_event-bus-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_event-bus-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_event-bus-service.adoc
new file mode 100644
index 0000000..43275fe
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_event-bus-service.adoc
@@ -0,0 +1,15 @@
+= `EventBusService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+## Implementation
+
+IMPORTANT: TODO
+
+## Registration
+
+The `EventBusServiceJdo` class provides the default implementation and (as of 1.6.0+) is automatically registered using `@DomainService`. No further configuration is necessary.
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_guice-bean-provider.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_guice-bean-provider.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_guice-bean-provider.adoc
new file mode 100644
index 0000000..99f4f36
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_guice-bean-provider.adoc
@@ -0,0 +1,8 @@
+= `GuiceBeanProvider`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_isis-jdo-support.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_isis-jdo-support.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_isis-jdo-support.adoc
new file mode 100644
index 0000000..3c1873a
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_isis-jdo-support.adoc
@@ -0,0 +1,129 @@
+= `IsisJdoSupport`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+
+The `IsisJdoSupport` service provides a number of general purpose methods for working with the JDO/DataNucleus objectstore.
+
+
+== API
+
+The API provided by `IsisJdoSupport` is:
+
+[source,java]
+----
+public interface IsisJdoSupport {
+ List<Map<String, Object>> executeSql(String sql);
+ Integer executeUpdate(String sql);
+ void deleteAll(Class<?>... pcClasses);
+ <T> T refresh(T domainObject);
+ void ensureLoaded(Collection<?> collectionOfDomainObjects);
+ PersistenceManager getJdoPersistenceManager();
+}
+----
+
+Each of these methods are discussed in more details below.
+
+
+== Executing arbitrary SQL
+
+The `executeSql(...)` method allows arbitrary queries to be submitted:
+
+[source,java]
+----
+List<Map<String, Object>> results = isisJdoSupport.executeSql("select * from custMgmt.customers");
+----
+
+The result set is automatically converted into a list of maps, where the map key is the column name.
+
+
+In a similar manner, the `executeUpdate(...)` allows arbitrary updates to be performed.
+
+[source,java]
+----
+int count = isisJdoSupport.executeUpdate("select count(*) from custMgmt.customers);
+----
+
+The returned value is the number of rows updated.
+
+
+
+== Fixture support
+
+The `deleteAll(...)` method is provided pretty much exclusively for tearing down fixture data:
+
+[source,java]
+----
+deleteAll(Order.class);
+deleteAll(CustomerAddress.class);
+deleteAll(Customer.class);
+----
+
+[NOTE]
+====
+It can occasionally be the case that Isis' internal adapter for the domain object is
+still in memory. JDO/DataNucleus seems to bump up the version of the object prior to its deletion,
+which under normal circumstances would cause Isis to throw a concurrency exception. Therefore
+to prevent this from happening (ie to <i>force</i> the deletion of all instances), concurrency checking
+is temporarily disabled while this method is performed.
+====
+
+
+
+== Reloading entities
+
+A http://www.datanucleus.org/products/datanucleus/jdo/orm/relationships.html[known limitation] of DataNucleus' implementation of JDO is that persisting a child entity (in a 1:n bidirectional relationship) does not cause the parent's collection to be updated.
+
+The `refresh(T domainObject)` method can be used to reload the parent object (or indeed any object).
+
+For example:
+
+[source,java]
+----
+public Order newOrder(final Customer customer) {
+ Order order = newTransientInstance(Order.class);
+ order.setCustomer(customer);
+ persist(customer);
+ getContainer().flush(); // <1>
+ isisJdoSupport.refresh(customer); // <2>
+ return order;
+}
+----
+<1> flush to database
+<2> reload parent from database
+
+
+[NOTE]
+====
+The particular example that led to this method being added was a 1:m bidirectional relationship,
+analogous to `Customer <-> * Order`. Persisting the child `Order` object did not cause
+the parent ``Customer``'s collection of orders to be updated. In fact, JDO does not make any
+such guarantee to do so. Options are therefore either to maintain the collection in code, or to
+refresh the parent.
+
+====
+
+
+
+
+== Using JDO `PersistenceManager` directly
+
+Apache Isis provides a simplified API on top of only supports JDO, and so does not support all of JDO's features. For example, Isis (currently) only supports named queries. If you require more flexibility than this, eg for dynamically constructed queries, then the service provides access to the underlying JDO `PersistenceManager` API:
+
+[source,java]
+----
+public List<Order> findOrders(...) {
+ javax.jdo.PersistenceManager pm = isisJdoSupport.getPersistenceManager();
+
+ // knock yourself out...
+
+ return someListOfOrders;
+}
+----
+
+
+
+== Registering the Service
+
+The `IsisJdoSupportImpl` class provides the default implementation and (as of 1.6.0+) is automatically registered using `@DomainService`. No further configuration is necessary.
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_memento-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_memento-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_memento-service.adoc
new file mode 100644
index 0000000..f06a824
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_memento-service.adoc
@@ -0,0 +1,8 @@
+= `MementoService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_metamodel-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_metamodel-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_metamodel-service.adoc
new file mode 100644
index 0000000..cb298dc
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_metamodel-service.adoc
@@ -0,0 +1,8 @@
+= `MetamodelService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_query-results-cache.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_query-results-cache.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_query-results-cache.adoc
new file mode 100644
index 0000000..0b22d23
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_query-results-cache.adoc
@@ -0,0 +1,8 @@
+= `QueryResultsCache`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_scratch-pad.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_scratch-pad.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_scratch-pad.adoc
new file mode 100644
index 0000000..0a11596
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_scratch-pad.adoc
@@ -0,0 +1,8 @@
+= `ScratchPad`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_sudo-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_sudo-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_sudo-service.adoc
new file mode 100644
index 0000000..bb33642
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_sudo-service.adoc
@@ -0,0 +1,8 @@
+= `SudoService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_wrapper-factory.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_wrapper-factory.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_wrapper-factory.adoc
new file mode 100644
index 0000000..75e9d25
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_wrapper-factory.adoc
@@ -0,0 +1,8 @@
+= `WrapperFactory`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_xml-snapshot-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_xml-snapshot-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_xml-snapshot-service.adoc
new file mode 100644
index 0000000..f82a24a
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_xml-snapshot-service.adoc
@@ -0,0 +1,8 @@
+= `XmlSnapshotService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi.adoc
new file mode 100644
index 0000000..ddf79f6
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi.adoc
@@ -0,0 +1,25 @@
+= Domain Services (SPI)
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+
+IMPORTANT: TODO
+
+include::_user-guide_reference_services-spi_aaa.adoc[leveloffset=+1]
+
+include::_user-guide_reference_services-spi_auditing-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_background-command-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_class-discovery-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_command-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_content-mapping-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_content-negotiation-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_email-notification-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_event-serializer.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_exception-recognizer.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_locale-provider.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_publishing-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_translation-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_translations-resolver.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_user-profile-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_user-registration-service.adoc[leveloffset=+1]
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_aaa.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_aaa.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_aaa.adoc
new file mode 100644
index 0000000..fa3baef
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_aaa.adoc
@@ -0,0 +1,214 @@
+= Summary
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+
+
+IMPORTANT: TODO
+
+== Applib SPIs
+
+IMPORTANT: TODO
+
+.Domain Services
+[cols="2,4a,1,1", options="header"]
+|===
+
+|API
+|Maven Module +
+Impl'n (g: a:)
+|Implementation
+|Notes
+
+|<<__code_auditingservice3_code, `o.a.i.applib.` +
+`services.audit` +
+`AuditingService3`>>
+|``o.ia.m.audit`` +
+``isis-module-audit``
+|`AuditingService`
+|related services:
+`AuditingService-` +
+`Contributions`,
+`AuditingService-` +
+`Repository`
+
+|<<__code_backgroundcommandservice_code, `o.a.i.applib.` +
+`services.background` +
+`BackgroundCommandService`>>
+|``o.ia.m.command`` +
+``isis-module-command``
+|`BackgroundCommandServiceJdo`
+|related services:
+`BackgroundCommandService-` +
+`JdoContributions`,
+`BackgroundCommandService-` +
+`JdoRepository`
+
+|<<__code_classdiscoveryservice_code, `o.a.i.applib.` +
+`services.classdiscovery` +
+`ClassDiscoveryService`>>
+|``o.a.i.core`` +
+``isis-core-applib``
+|`ClassDiscoveryService-` +
+`UsingReflections`
+|requires `org.reflections:reflections` as Maven dependency
+
+|<<__code_commandservice_code, `o.a.i.applib.` +
+`services.command.spi` +
+`CommandService`>>
+|``o.ia.m.command`` +
+``isis-module-command``
+|`CommandServiceJdo`
+|related services: +
+`CommandService-` ++
+`JdoContributions`,
+`CommandService-` ++
+`JdoRepository`
+
+|<<__code_emailnotificationservice_code, `o.a.i.applib.` +
+`services.userreg` +
+`EmailNotificationService`>>
+|``o.a.i.core`` +
+``isis-core-runtime``
+|`EmailNotificationService-` ++
+`Default`
+|depends on: +
+a configured `EmailService`
+
+|<<__code_eventserializer_code, `o.a.i.applib.` +
+`services.publish` +
+`EventSerializer`>>
+|``o.ia.m.publishing`` +
+``isis-module-publishing``
+|`RestfulObjects-` +
+`SpecEventSerializer`
+|
+
+|<<__code_exceptionrecognizer_code, `o.a.i.applib.` +
+`services.exceprecog` +
+`ExceptionRecognizer`>>
+|``o.a.i.core`` +
+``isis-core-applib``
+|`ExceptionRecognizer-` +
+`CompositeFor-` +
+`JdoObjectStore`
+|Extensible using composite pattern if required
+
+|<<__code_localeprovider_code, `o.a.i.applib.` +
+`services.i18n` +
+`LocaleProvider`>>
+|``o.a.i.viewer`` +
+``isis-viewer-wicket-impl``
+|`LocaleProviderWicket`
+|
+
+|<<__code_publishingservice_code, `o.a.i.applib.` +
+`services.publish` +
+`PublishingService`>>
+|``o.ia.m.publishing`` +
+``isis-module-publishing``
+|`PublishingService`
+|related services:
+`PublishingService-` ++
+`Contributions`,
+`PublishingService-` ++
+`Repository`. +
+depends on: +
+`EventSerializer`
+
+|<<__code_translationservice_code, `o.a.i.applib.` +
+`services.i18n` +
+`TranslationService`>>
+|``o.a.i.core`` +
+``isis-core-runtime``
+|`TranslationServicePo`
+|related services: `TranslationServicePoMenu` +
+depends on: +
+`TranslationsResolver`, `LocaleProvider`
+
+|<<__code_translationsresolver_code, `o.a.i.applib.` +
+`services.i18n` +
+`TranslationsResolver`>>
+|``o.a.i.viewer`` +
+``isis-viewer-wicket-impl``
+|`TranslationsResolverWicket`
+|
+
+|<<__code_userprofileservice_code, `o.a.i.applib.` +
+`services.userprof` +
+`UserProfileService`>>
+|
+|
+|SPI only
+
+|<<__code_userregistrationservice_code, `o.a.i.applib.` +
+`services.userreg` +
+`UserRegistrationService`>>
+|``o.ia.m.security`` +
+``isis-module-security``
+|`SecurityModule-` +
+`AppUserRegistrationService`
+|depends (implicitly) on: +
+a configured `EmailService`
+
+
+|===
+
+
+Key:
+
+* `o.a.i` is an abbreviation for `org.apache.isis`
+* `o.ia.m` is an abbreviation for `org.isisaddons.module`
+
+
+All domain services are automatically registered (annotated with <<__code_domainservice_code, `@DomainService`>>) except:
+
+
+
+* `ExceptionRecognizer` +
++
+Register explicitly in isis.properties (so is extensible)
+
+
+
+
+
+== "Internal" SPIs
+
+These services definitions depend on the internals of the framework; we do not guarantee that link:semver.org[semantic versioning] will be honoured for these APIs.
+
+
+.Semi-public SPI
+[cols="3,3,2,2a", options="header"]
+|===
+
+|SPI
+|Maven Module +
+Impl'n (g: a:)
+|Implementation
+|Notes
+
+
+|<<__code_contentmappingservice_code, `o.a.i.v.ro.` +
+`rendering.service.conneg.` +
+`ContentMappingService`>>
+|
+|
+|No default implementation.
+
+|<<__code_contentnegotiationservice_code, `o.a.i.v.ro.` +
+`rendering.service.conneg.` +
+`ContentNegotiationService`>>
+|``o.a.i.core`` +
+`isis-core-viewer-restfulobjects-rendering`
+|`ContentNegotiationService-` +
+`XRoDomainType`
+|
+
+
+|===
+
+Key:
+
+* `o.a.i.v.ro` is an abbreviation for `org.apache.isis.viewer.restfulobjects`
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_auditing-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_auditing-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_auditing-service.adoc
new file mode 100644
index 0000000..e4626d2
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_auditing-service.adoc
@@ -0,0 +1,13 @@
+= `AuditingService3`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
+
+
+== Isis Addons Implementation
+
+For 1.7.0+, see the http://github.com/isisaddons/isis-module-audit[Isis addons' Audit module] (non-ASF).
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_background-command-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_background-command-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_background-command-service.adoc
new file mode 100644
index 0000000..3111628
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_background-command-service.adoc
@@ -0,0 +1,12 @@
+= `BackgroundCommandService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
+== Isis Addons Implementation
+
+For 1.7.0+, see the http://github.com/isisaddons/isis-module-command[Isis addons' Command module] (non-ASF).
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_class-discovery-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_class-discovery-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_class-discovery-service.adoc
new file mode 100644
index 0000000..075cf62
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_class-discovery-service.adoc
@@ -0,0 +1,8 @@
+= `ClassDiscoveryService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_command-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_command-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_command-service.adoc
new file mode 100644
index 0000000..ab86189
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_command-service.adoc
@@ -0,0 +1,11 @@
+= `CommandService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
+== Isis Addons Implementation
+
+For 1.7.0+, see the http://github.com/isisaddons/isis-module-command[Isis addons' Command module] (non-ASF).
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_content-mapping-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_content-mapping-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_content-mapping-service.adoc
new file mode 100644
index 0000000..09d20f9
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_content-mapping-service.adoc
@@ -0,0 +1,8 @@
+= `ContentMappingService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_content-negotiation-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_content-negotiation-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_content-negotiation-service.adoc
new file mode 100644
index 0000000..89933f9
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_content-negotiation-service.adoc
@@ -0,0 +1,8 @@
+= `ContentNegotiationService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_email-notification-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_email-notification-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_email-notification-service.adoc
new file mode 100644
index 0000000..2a99016
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_email-notification-service.adoc
@@ -0,0 +1,8 @@
+= `EmailNotificationService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_event-serializer.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_event-serializer.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_event-serializer.adoc
new file mode 100644
index 0000000..2c20560
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_event-serializer.adoc
@@ -0,0 +1,8 @@
+= `EventSerializer`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_exception-recognizer.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_exception-recognizer.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_exception-recognizer.adoc
new file mode 100644
index 0000000..04e7561
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_exception-recognizer.adoc
@@ -0,0 +1,8 @@
+= `ExceptionRecognizer`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_locale-provider.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_locale-provider.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_locale-provider.adoc
new file mode 100644
index 0000000..4956f49
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_locale-provider.adoc
@@ -0,0 +1,8 @@
+= `LocaleProvider`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_publishing-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_publishing-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_publishing-service.adoc
new file mode 100644
index 0000000..93b17c1
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_publishing-service.adoc
@@ -0,0 +1,11 @@
+= `PublishingService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
+== Isis Addons Implementation
+
+For 1.7.0+, see the http://github.com/isisaddons/isis-module-publishing[Isis addons' Publishing module] (non-ASF).
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_translation-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_translation-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_translation-service.adoc
new file mode 100644
index 0000000..0c1b16e
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_translation-service.adoc
@@ -0,0 +1,8 @@
+= `TranslationService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_translations-resolver.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_translations-resolver.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_translations-resolver.adoc
new file mode 100644
index 0000000..7148bc7
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_translations-resolver.adoc
@@ -0,0 +1,8 @@
+= `TranslationsResolver`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_user-profile-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_user-profile-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_user-profile-service.adoc
new file mode 100644
index 0000000..6b56835
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_user-profile-service.adoc
@@ -0,0 +1,8 @@
+= `UserProfileService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_user-registration-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_user-registration-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_user-registration-service.adoc
new file mode 100644
index 0000000..ab1a666
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_user-registration-service.adoc
@@ -0,0 +1,8 @@
+= `UserRegistrationService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services.adoc
deleted file mode 100644
index e4eff00..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services.adoc
+++ /dev/null
@@ -1,45 +0,0 @@
-= Domain Services
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-
-IMPORTANT: TODO
-
-include::_user-guide_reference_services_aaa.adoc[leveloffset=+1]
-
-include::_user-guide_reference_services_action-invocation-context.adoc[leveloffset=+1]
-include::_user-guide_reference_services_auditing-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_background-command-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_background-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_bookmark-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_class-discovery-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_clock-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_command-context.adoc[leveloffset=+1]
-include::_user-guide_reference_services_command-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_content-mapping-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_content-negotiation-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_deep-link-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_domain-object-container.adoc[leveloffset=+1]
-include::_user-guide_reference_services_email-notification-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_email-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_event-bus-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_event-serializer.adoc[leveloffset=+1]
-include::_user-guide_reference_services_exception-recognizer.adoc[leveloffset=+1]
-include::_user-guide_reference_services_fixture-scripts.adoc[leveloffset=+1]
-include::_user-guide_reference_services_guice-bean-provider.adoc[leveloffset=+1]
-include::_user-guide_reference_services_isis-jdo-support.adoc[leveloffset=+1]
-include::_user-guide_reference_services_locale-provider.adoc[leveloffset=+1]
-include::_user-guide_reference_services_memento-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_metamodel-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_publishing-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_query-results-cache.adoc[leveloffset=+1]
-include::_user-guide_reference_services_scratch-pad.adoc[leveloffset=+1]
-include::_user-guide_reference_services_sudo-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_translation-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_translations-resolver.adoc[leveloffset=+1]
-include::_user-guide_reference_services_user-profile-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_user-registration-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_wrapper-factory.adoc[leveloffset=+1]
-include::_user-guide_reference_services_xml-snapshot-service.adoc[leveloffset=+1]
-