Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Enums
• Deprecated Exceptions
• Deprecated Fields
• Deprecated Methods

Deprecated Interfaces

Interface and Description
org.apache.sling.engine.auth.AuthenticationHandler use AuthenticationHandler instead
org.apache.sling.engine.auth.Authenticator use AuthenticationSupport instead
org.apache.sling.commons.classloader.DynamicClassLoaderProvider The dynamic class loader provider is not supported anymore and any service implementing this is not considered for dynamic class loading anymore!
org.apache.sling.jcr.resource.JcrResourceResolverFactory Since 2.1. Use the ResourceResolverFactory
org.apache.sling.event.jobs.JobProcessor - Use the new JobConsumer interface instead.
org.apache.sling.event.JobProcessor Use org.apache.sling.event.jobs.JobProcessor
org.apache.sling.event.jobs.JobsIterator - Use the new JobManager.findJobs(org.apache.sling.event.jobs.JobManager.QueryType, java.lang.String, long, java.util.Map<java.lang.String, java.lang.Object>...) methods instead.
org.apache.sling.event.JobsIterator
org.apache.sling.event.JobStatusProvider
org.apache.sling.api.resource.PersistableValueMap Use the ModifiableValueMap instead.
org.apache.sling.engine.RequestLog Use the request progress tracker instead.
org.apache.sling.servlets.post.SlingPostOperation as of 2.0.8 (Bundle version 2.2.0) and replaced by PostOperation.
org.apache.sling.api.scripting.SlingScriptResolver The SlingScriptResolver interface is intended to be implemented and also used by project specific code. To keep the API as clean as possible this interface was deprecated
org.apache.sling.engine.SlingSettingsService Use the SlingSettingsService
org.apache.sling.event.TimedEventStatusProvider Use scheduled jobs instead

Deprecated Classes

Class and Description
org.apache.sling.auth.core.spi.AbstractAuthenticationHandler since Bundle 1.0.8; AuthenticationHandler implementations should extend DefaultAuthenticationFeedbackHandler directly and use the utility methods in the AuthUtil class.
org.apache.sling.jcr.base.AbstractNamespaceMappingRepository as of API version 2.3 (bundle version 2.3). Use NamespaceMappingSupport or AbstractSlingRepositoryManager and AbstractSlingRepository2 instead.
org.apache.sling.engine.servlets.AbstractServiceReferenceConfig
org.apache.sling.servlets.post.AbstractSlingPostOperation as of 2.0.8 (Bundle version 2.2.0) and replaced by AbstractPostOperation.
org.apache.sling.jcr.base.AbstractSlingRepository as of API version 2.3 (bundle version 2.3). Use AbstractSlingRepositoryManager and AbstractSlingRepository2 instead.
org.apache.sling.engine.auth.AuthenticationInfo see AuthenticationHandler
org.apache.sling.event.EventPropertiesMap EventAdmin supports creating events with maps now as well.
org.apache.sling.api.servlets.HtmlResponse use org.apache.sling.servlets.post.HtmlResponse instead.
org.apache.sling.event.jobs.JobUtil
org.apache.sling.commons.osgi.OsgiUtil Use PropertiesUtil and ServiceUtil instead
org.apache.sling.engine.RequestUtil Use RequestUtil
org.apache.sling.engine.ResponseUtil Use ResponseUtil
org.apache.sling.adapter.SlingAdaptable Use the SlingAdaptable instead

Deprecated Enums

Enum and Description
org.apache.sling.event.EventUtil.JobPriority Use JobUtil.JobPriority
org.apache.sling.event.jobs.JobUtil.JobPriority

Deprecated Exceptions

Exceptions and Description
org.apache.sling.engine.auth.NoAuthenticationHandlerException see Authenticator
org.apache.sling.jcr.api.TooManySessionsException Session pooling has been removed and thus this exception is not used any more.

Deprecated Fields

Field and Description
org.apache.sling.engine.EngineConstants.FILTER_ORDER Use "service.ranking" (org.osgi.framework.Constants.SERVICE_RANKING) instead
org.apache.sling.engine.EngineConstants.FILTER_SCOPE Use EngineConstants.SLING_FILTER_SCOPE instead
org.apache.sling.event.jobs.JobUtil.JOB_ID - Use the new Job interface instead.
org.apache.sling.event.jobs.JobUtil.NOTIFICATION_PROPERTY_JOB_ID Use NotificationConstants#NOTIFICATION_PROPERTY_JOB_ID
org.apache.sling.event.jobs.JobUtil.NOTIFICATION_PROPERTY_JOB_NAME
org.apache.sling.event.jobs.JobUtil.NOTIFICATION_PROPERTY_JOB_TOPIC Use NotificationConstants#NOTIFICATION_PROPERTY_JOB_TOPIC
org.apache.sling.event.JobStatusProvider.PROPERTY_EVENT_ID Use JobUtil.JOB_ID
org.apache.sling.event.jobs.JobUtil.PROPERTY_JOB_APPLICATION - Use the new Job interface instead.
org.apache.sling.event.jobs.JobUtil.PROPERTY_JOB_CREATED - Use the new Job interface instead.
org.apache.sling.event.jobs.JobUtil.PROPERTY_JOB_CREATED_APPLICATION - Use the new Job interface instead.
org.apache.sling.event.EventUtil.PROPERTY_JOB_ID Use JobUtil.PROPERTY_JOB_NAME
org.apache.sling.event.jobs.JobUtil.PROPERTY_JOB_NAME - Jobs should be started via JobManager.addJob(String, String, java.util.Map)
org.apache.sling.event.jobs.JobUtil.PROPERTY_JOB_PARALLEL
org.apache.sling.event.EventUtil.PROPERTY_JOB_PARALLEL Use JobUtil.PROPERTY_JOB_PARALLEL
org.apache.sling.event.jobs.Job.PROPERTY_JOB_PRIORITY
org.apache.sling.event.jobs.JobUtil.PROPERTY_JOB_PRIORITY - Use the new Job interface instead.
org.apache.sling.event.EventUtil.PROPERTY_JOB_PRIORITY Use JobUtil.PROPERTY_JOB_PRIORITY
org.apache.sling.event.jobs.JobUtil.PROPERTY_JOB_QUEUE_NAME - Use the new Job interface instead.
org.apache.sling.event.EventUtil.PROPERTY_JOB_QUEUE_NAME Use JobUtil.PROPERTY_JOB_QUEUE_NAME
org.apache.sling.event.jobs.JobUtil.PROPERTY_JOB_QUEUE_ORDERED
org.apache.sling.event.EventUtil.PROPERTY_JOB_QUEUE_ORDERED Use JobUtil.PROPERTY_JOB_QUEUE_ORDERED
org.apache.sling.event.jobs.JobUtil.PROPERTY_JOB_RETRIES - Use the new Job interface instead.
org.apache.sling.event.EventUtil.PROPERTY_JOB_RETRIES Use JobUtil.PROPERTY_JOB_RETRIES
org.apache.sling.event.jobs.JobUtil.PROPERTY_JOB_RETRY_COUNT - Use the new Job interface instead.
org.apache.sling.event.EventUtil.PROPERTY_JOB_RETRY_COUNT Use JobUtil.PROPERTY_JOB_RETRY_COUNT
org.apache.sling.event.jobs.JobUtil.PROPERTY_JOB_RETRY_DELAY - Use the new Job interface instead.
org.apache.sling.event.EventUtil.PROPERTY_JOB_RETRY_DELAY Use JobUtil.PROPERTY_JOB_RETRY_DELAY
org.apache.sling.event.jobs.JobUtil.PROPERTY_JOB_RUN_LOCAL
org.apache.sling.event.EventUtil.PROPERTY_JOB_RUN_LOCAL Use JobUtil.PROPERTY_JOB_RUN_LOCAL
org.apache.sling.event.jobs.JobUtil.PROPERTY_JOB_TOPIC - Jobs should be started via JobManager.addJob(String, String, java.util.Map)
org.apache.sling.event.EventUtil.PROPERTY_JOB_TOPIC Use JobUtil.PROPERTY_JOB_TOPIC
org.apache.sling.event.jobs.JobUtil.PROPERTY_NOTIFICATION_JOB
org.apache.sling.event.EventUtil.PROPERTY_NOTIFICATION_JOB Use JobUtil.PROPERTY_NOTIFICATION_JOB
org.apache.sling.event.EventUtil.PROPERTY_TIMED_EVENT_DATE Use scheduled jobs instead
org.apache.sling.event.EventUtil.PROPERTY_TIMED_EVENT_ID Use scheduled jobs instead
org.apache.sling.event.EventUtil.PROPERTY_TIMED_EVENT_PERIOD Use scheduled jobs instead
org.apache.sling.event.EventUtil.PROPERTY_TIMED_EVENT_SCHEDULE Use scheduled jobs instead
org.apache.sling.event.EventUtil.PROPERTY_TIMED_EVENT_TOPIC Use scheduled jobs instead
org.apache.sling.api.resource.ResourceResolver.REQUEST_ATTR_WORKSPACE_INFO
org.apache.sling.engine.EngineConstants.SESSION as of bundle version 2.1
org.apache.sling.engine.EngineConstants.SLING_CURRENT_SERVLET_NAME Use SlingConstants.SLING_CURRENT_SERVLET_NAME
org.apache.sling.engine.EngineConstants.SLING_HOME Use SlingSettingsService.SLING_HOME
org.apache.sling.engine.EngineConstants.SLING_HOME_URL Use SlingSettingsService.SLING_HOME_URL
org.apache.sling.engine.EngineConstants.SLING_SERLVET_NAME
org.apache.sling.event.jobs.JobUtil.TOPIC_JOB - Use the new JobManager.addJob(String, String, java.util.Map) method instead.
org.apache.sling.event.EventUtil.TOPIC_JOB Use JobUtil.TOPIC_JOB
org.apache.sling.event.jobs.JobUtil.TOPIC_JOB_CANCELLED Use NotificationConstants#TOPIC_JOB_CANCELLED
org.apache.sling.event.EventUtil.TOPIC_JOB_CANCELLED Use JobUtil.TOPIC_JOB_CANCELLED
org.apache.sling.event.jobs.JobUtil.TOPIC_JOB_FAILED Use NotificationConstants#TOPIC_JOB_FAILED
org.apache.sling.event.EventUtil.TOPIC_JOB_FAILED Use JobUtil.TOPIC_JOB_FAILED
org.apache.sling.event.jobs.JobUtil.TOPIC_JOB_FINISHED Use NotificationConstants#TOPIC_JOB_FINISHED
org.apache.sling.event.EventUtil.TOPIC_JOB_FINISHED Use JobUtil.TOPIC_JOB_FINISHED
org.apache.sling.event.jobs.JobUtil.TOPIC_JOB_STARTED Use NotificationConstants#TOPIC_JOB_STARTED
org.apache.sling.event.EventUtil.TOPIC_JOB_STARTED Use JobUtil.TOPIC_JOB_STARTED
org.apache.sling.event.EventUtil.TOPIC_TIMED_EVENT Use scheduled jobs instead

Deprecated Methods

Method and Description
org.apache.sling.event.jobs.JobUtil.acknowledgeJob(Event) - Use the new JobConsumer interface instead.
org.apache.sling.event.EventUtil.acknowledgeJob(Event) Use JobUtil.acknowledgeJob(Event)
org.apache.sling.installer.api.tasks.InstallationContext.addAsyncTask(InstallTask) A async task should return true for InstallTask.isAsynchronousTask() and be add with InstallationContext.addTaskToCurrentCycle(InstallTask)
org.apache.sling.commons.scheduler.Scheduler.addJob(String, Object, Map<String, Serializable>, String, boolean) Use Scheduler.schedule(Object, ScheduleOptions) instead.
org.apache.sling.event.jobs.JobManager.addJob(String, String, Map<String, Object>)
org.apache.sling.commons.scheduler.Scheduler.addPeriodicJob(String, Object, Map<String, Serializable>, long, boolean) Use Scheduler.schedule(Object, ScheduleOptions) instead.
org.apache.sling.commons.scheduler.Scheduler.addPeriodicJob(String, Object, Map<String, Serializable>, long, boolean, boolean) Use Scheduler.schedule(Object, ScheduleOptions) instead.
org.apache.sling.installer.api.tasks.InstallationContext.addTaskToNextCycle(InstallTask)
org.apache.sling.event.JobStatusProvider.cancelJob(String) Use JobStatusProvider.removeJob(String) instead.
org.apache.sling.event.JobStatusProvider.cancelJob(String, String) Use JobStatusProvider.removeJob(String, String) instead.
org.apache.sling.api.resource.ResourceDecorator.decorate(Resource, HttpServletRequest) since 2.3.0 (and JCR Resource 2.1.0), this method will not be invoked.
org.apache.sling.api.scripting.SlingScriptHelper.dispose() This method is deprecated since version 2.1 and will be removed. It should never be called by clients.
org.apache.sling.scripting.core.ScriptHelper.dispose()
org.apache.sling.event.jobs.JobManager.findJob(String, Map<String, Object>) Use JobManager.getJob(String, Map)
org.apache.sling.api.resource.ResourceUtil.findResourceSuperType(Resource) Use ResourceResolver.getParentResourceType(Resource)
org.apache.sling.event.jobs.JobUtil.finishedJob(Event) - Use the new JobConsumer interface instead.
org.apache.sling.event.EventUtil.finishedJob(Event) Use {link JobUtil.finishedJob(Event)
org.apache.sling.commons.scheduler.Scheduler.fireJob(Object, Map<String, Serializable>) Use Scheduler.schedule(Object, ScheduleOptions) instead.
org.apache.sling.commons.scheduler.Scheduler.fireJob(Object, Map<String, Serializable>, int, long) Use Scheduler.schedule(Object, ScheduleOptions) instead.
org.apache.sling.commons.scheduler.Scheduler.fireJobAt(String, Object, Map<String, Serializable>, Date) Use Scheduler.schedule(Object, ScheduleOptions) instead.
org.apache.sling.commons.scheduler.Scheduler.fireJobAt(String, Object, Map<String, Serializable>, Date, int, long) Use Scheduler.schedule(Object, ScheduleOptions) instead.
org.apache.sling.event.jobs.JobManager.forceRemoveJob(String) Use JobManager.removeJobById(String)
org.apache.sling.api.resource.ResourceProviderFactory.getAdministrativeResourceProvider(Map<String, Object>) as of 2.4 (bundle version 2.5.0) because of inherent security issues. Implementations may implement this method at their discretion but must support the new service based resource provider generation in the ResourceProviderFactory.getResourceProvider(Map) method honoring the ResourceProviderFactory.SERVICE_BUNDLE and ResourceResolverFactory.SUBSERVICE properties.
org.apache.sling.api.resource.ResourceResolverFactory.getAdministrativeResourceResolver(Map<String, Object>) as of 2.4 (bundle version 2.5.0) because of inherent security issues. Services requiring specific permissions should use the ResourceResolverFactory.getServiceResourceResolver(Map) instead.
org.apache.sling.event.JobStatusProvider.getAllJobs(String, Map<String, Object>...) Use JobStatusProvider.queryAllJobs(String, Map...) instead.
org.apache.sling.event.jobs.QueueConfiguration.getApplicationIds() This information is not used anymore
org.apache.sling.auth.core.spi.AbstractAuthenticationHandler.getAttributeOrParameter(HttpServletRequest, String, String) since Bundle 1.0.8, use AuthUtil.getAttributeOrParameter(HttpServletRequest, String, String)
org.apache.sling.event.JobStatusProvider.getCurrentJobs(String) Use JobStatusProvider.queryCurrentJobs(String, Map...) instead.
org.apache.sling.event.JobStatusProvider.getCurrentJobs(String, Map<String, Object>...) Use JobStatusProvider.queryCurrentJobs(String, Map...) instead.
org.apache.sling.event.jobs.JobManager.getJobByName(String)
org.apache.sling.event.jobs.JobUtil.getJobCreated(Event) - Use the new Job interface instead.
org.apache.sling.event.jobs.Job.getJobPriority()
org.apache.sling.auth.core.spi.AbstractAuthenticationHandler.getLoginResource(HttpServletRequest, String) since Bundle 1.0.8, use AuthUtil.getLoginResource(HttpServletRequest, String)
org.apache.sling.event.jobs.Job.getName()
org.apache.sling.api.resource.ResourceUtil.getName(Resource) since 2.1.0, use Resource.getName() instead
org.apache.sling.api.resource.ResourceUtil.getParent(Resource) since 2.1.0, use Resource.getParent() instead
org.apache.sling.jcr.resource.JcrPropertyMap.getPath()
org.apache.sling.event.jobs.QueueConfiguration.getPriority() Use QueueConfiguration.getThreadPriority()
org.apache.sling.commons.osgi.OsgiUtil.getProperty(Object, double) since 2.0.4, use OsgiUtil.toDouble(Object, double) instead
org.apache.sling.api.resource.ResourceProvider.getResource(ResourceResolver, HttpServletRequest, String) since 2.2.0 (and JCR Resource 2.1.0), this method will not be invoked.
org.apache.sling.jcr.resource.JcrResourceUtil.getResourceSuperType(Resource) Call ResourceUtil.findResourceSuperType(Resource)
org.apache.sling.api.resource.ResourceUtil.getResourceSuperType(ResourceResolver, String) Use ResourceResolver.getParentResourceType(String)
org.apache.sling.jcr.resource.JcrResourceUtil.getResourceSuperType(ResourceResolver, String) Use ResourceUtil.getResourceSuperType(ResourceResolver, String)
org.apache.sling.event.JobStatusProvider.getScheduledJobs(String) Use JobStatusProvider.queryScheduledJobs(String, Map...) instead.
org.apache.sling.event.JobStatusProvider.getScheduledJobs(String, Map<String, Object>...) Use JobStatusProvider.queryScheduledJobs(String, Map...) instead.
org.apache.sling.api.resource.ResourceUtil.getValueMap(Resource) Use Resource.getValueMap().
org.apache.sling.api.resource.ResourceUtil.isA(Resource, String) Use ResourceResolver.isResourceType(Resource, String)
org.apache.sling.event.jobs.JobUtil.isJobEvent(Event) - Use the new Job interface instead.
org.apache.sling.event.EventUtil.isJobEvent(Event) Use JobUtil.isJobEvent(Event)
org.apache.sling.event.jobs.JobManager.isJobProcessingEnabled() This method always returns true
org.apache.sling.event.jobs.QueueConfiguration.isLocalQueue() This information is not used anymore
org.apache.sling.auth.core.spi.AbstractAuthenticationHandler.isRedirectValid(HttpServletRequest, String) This method has been introduced after Bundle release 1.0.6 but has been replaced with AuthUtil.isRedirectValid(HttpServletRequest, String). Use the latter method.
org.apache.sling.auth.core.spi.AbstractAuthenticationHandler.isValidateRequest(HttpServletRequest) since Bundle 1.0.8, use AuthUtil.isValidateRequest(HttpServletRequest)
org.apache.sling.scripting.javascript.wrapper.ScriptableResource.jsFunction_getMetadata() since 2.1.0 because the method is named incorrectly.
org.apache.sling.scripting.javascript.wrapper.ScriptableResource.jsGet_meta() since 2.1.0 because it maps the method name incorrectly.
org.apache.sling.scripting.javascript.wrapper.ScriptableResource.jsGet_type() since 2.1.0 because it maps the method name incorrectly.
org.apache.sling.api.resource.ResourceUtil.listChildren(Resource) since 2.1.0, use Resource.listChildren() instead
org.apache.sling.jcr.api.SlingRepository.loginAdministrative(String) as of 2.2 (bundle version 2.2.0) because of inherent security issues. Services requiring specific permissions should use the SlingRepository.loginService(String, String) instead.
org.apache.sling.event.jobs.JobUtil.processJob(Event, JobProcessor) - Use the new JobConsumer interface instead.
org.apache.sling.event.EventUtil.processJob(Event, JobProcessor) Use JobUtil.processJob(Event, org.apache.sling.event.jobs.JobProcessor)
org.apache.sling.event.jobs.JobManager.queryJobs(JobManager.QueryType, String, long, Map<String, Object>...) Use JobManager.findJobs(QueryType, String, long, Map...)
org.apache.sling.event.jobs.JobManager.queryJobs(JobManager.QueryType, String, Map<String, Object>...) Use JobManager.findJobs(QueryType, String, long, Map...)
org.apache.sling.commons.scheduler.Scheduler.removeJob(String) Use Scheduler.unschedule(String) instead.
org.apache.sling.event.jobs.JobManager.removeJob(String) Use JobManager.removeJobById(String)
org.apache.sling.jcr.base.util.AccessControlUtil.replaceAccessControlEntry(Session, String, Principal, String[], String[], String[]) use @link AccessControlUtil.replaceAccessControlEntry(Session, String, Principal, String[], String[], String[], String) instead.
org.apache.sling.event.jobs.JobUtil.rescheduleJob(Event) - Use the new JobConsumer interface instead.
org.apache.sling.event.EventUtil.rescheduleJob(Event) Use JobUtil.rescheduleJob(Event)
org.apache.sling.api.resource.ResourceResolver.resolve(HttpServletRequest) as of 2.0.4, use ResourceResolver.resolve(HttpServletRequest, String) instead.
org.apache.sling.jcr.resource.JcrResourceUtil.resourceTypeToPath(String) Use ResourceUtil.resourceTypeToPath(String)
org.apache.sling.auth.core.spi.AbstractAuthenticationHandler.sendInvalid(HttpServletRequest, HttpServletResponse) since Bundle 1.0.8, use AuthUtil.sendInvalid(HttpServletRequest, HttpServletResponse)
org.apache.sling.auth.core.spi.AbstractAuthenticationHandler.sendRedirect(HttpServletRequest, HttpServletResponse, String, Map<String, String>) since Bundle 1.0.8, use AuthUtil.sendRedirect(HttpServletRequest, HttpServletResponse, String, Map)
org.apache.sling.auth.core.spi.AbstractAuthenticationHandler.sendValid(HttpServletResponse) since Bundle 1.0.8, use AuthUtil.sendValid(HttpServletResponse)
org.apache.sling.auth.core.spi.AbstractAuthenticationHandler.setLoginResourceAttribute(HttpServletRequest, String) since Bundle 1.0.8, use AuthUtil.setLoginResourceAttribute(HttpServletRequest, String)