How to use

DeprecationSupport

in

net.shibboleth.utilities.java.support.primitive

  /**
   * Constructor.  Added purely to generate the deprecation warning.
   */
  public AbstractDataConnectorParser() {
    super();
    DeprecationSupport.warn(ObjectType.CLASS, this.getClass().getName(), null, super.getClass().getName());
  }
}

@Override @Nullable public BaseContext getParent() {
  DeprecationSupport.warnOnce(ObjectType.CLASS, AttributeResolverWorkContext.class.getName(), null, null);
  return delegate.getParent();
}

  return;
DeprecationSupport.warnOnce(ObjectType.ELEMENT, "Resource",
    parserContext.getReaderContext().getResource().getDescription(),
    "resourceRef property");
  DeprecationSupport.warn(ObjectType.ELEMENT, ResourceNamespaceHandler.HTTP_ELEMENT_NAME.toString(),
      parserContext.getReaderContext().getResource().getDescription(),
      HTTPMetadataProviderParser.ELEMENT_NAME.toString());
  DeprecationSupport.warn(ObjectType.ELEMENT, ResourceNamespaceHandler.FILE_HTTP_ELEMENT_NAME.toString(),
      parserContext.getReaderContext().getResource().getDescription(),
      FileBackedHTTPMetadataProviderParser.ELEMENT_NAME.toString());
  DeprecationSupport.warn(ObjectType.ELEMENT, ResourceNamespaceHandler.FILESYSTEM_ELEMENT_NAME.toString(),
      parserContext.getReaderContext().getResource().getDescription(),
      FilesystemMetadataProviderParser.ELEMENT_NAME.toString());

/**
 * {@inheritDoc}
 *
 * @deprecated Use {@link #setAttributeNames} instead
 * @see        #setAttributeNames
 */
@Override @Deprecated public void setDependencyAttributeId(@Nullable final String attributeId) {
  DeprecationSupport.warn(ObjectType.METHOD,
      "ResolverDataConnectorDependency#setDependencyAttributeId(String)",
      null, "#setAttributeNames(Collection<String>)");
  super.setDependencyAttributeId(attributeId);
}

@Override @Nullable public <T extends BaseContext> T getSubcontext(@Nonnull final Class<T> clazz) {
  DeprecationSupport.warnOnce(ObjectType.CLASS, AttributeResolverWorkContext.class.getName(), null, null);
  return delegate.getSubcontext(clazz);
}

/**
 * Constructor.
 * 
 * @param file file to output to.
 * @throws FileNotFoundException if the file cannot be found.
 */
public MetadataGenerator(@Nonnull final File file) throws FileNotFoundException {
  DeprecationSupport.warn(ObjectType.CLASS, this.getClass().getName(), null , ".impl");
  final File nonnullFile = Constraint.isNotNull(file, "provided file must be nonnull");
  final FileOutputStream outStream = new FileOutputStream(nonnullFile);
  writer = new BufferedWriter(new OutputStreamWriter(outStream));
  endpoints = EnumSet.allOf(Endpoints.class);
}

@Override @Nullable public <T extends BaseContext> T getSubcontext(@Nonnull final Class<T> clazz,
    final boolean autocreate) {
  DeprecationSupport.warnOnce(ObjectType.CLASS, AttributeResolverWorkContext.class.getName(), null, null);
  return delegate.getSubcontext(clazz, autocreate);
}

/** {@inheritDoc} */
@Override
protected void doInitialize() throws ComponentInitializationException {
  super.doInitialize();
  
  DeprecationSupport.warn(ObjectType.CLASS, getClass().getName(), null, null);
}

/** {@inheritDoc} */
@Override @Nonnull public Iterator<BaseContext> iterator() {
  DeprecationSupport.warnOnce(ObjectType.CLASS, AttributeResolverWorkContext.class.getName(), null, null);
  return delegate.iterator();
}

/**
 * Constructor.
 * 
 * @param query to search the database
 * @deprecated - use the property setters
 */
@Deprecated public FormatExecutableStatementBuilder(@Nonnull final String query) {
  DeprecationSupport.warn(ObjectType.METHOD, "FormatExecutableStatementBuilder(String)", null, null);
  sqlQuery = Constraint.isNotNull(query, "SQL query can not be null");
}

/**
 * see {@link AttributeResolverWorkContext#recordDataConnectorResolution(DataConnector,Map)}.
 * 
 * @param connector as the delegate does
 * @param attributes as the delegate does
 * @throws ResolutionException as the delegate does
 */
public void recordDataConnectorResolution(@Nonnull final DataConnector connector,
    @Nullable final Map<String, IdPAttribute> attributes) throws ResolutionException {
  DeprecationSupport.warnOnce(ObjectType.CLASS, AttributeResolverWorkContext.class.getName(), null, null);
  log.error("'{}' Use of workContext.recordDataConnectorResolution() is deprecated and will cause instability",
      logPrefix);
  delegate.recordDataConnectorResolution(connector, attributes);
}

/**
 * Constructor.
 * 
 * @param attrName the name to filter on.
 * @deprecated use the property setter instead
 */
@Deprecated public IdPAttributePrincipalValuesFunction(@Nonnull final String attrName) {
  attributeName = Constraint.isNotNull(attrName, "Attribute Name should be non-null");
  DeprecationSupport.warn(ObjectType.METHOD, 
      "IdPAttributePrincipalValuesFunction(String)", null, null);
}

@Override public void removeSubcontext(@Nonnull final BaseContext subcontext) {
  DeprecationSupport.warnOnce(ObjectType.CLASS, AttributeResolverWorkContext.class.getName(), null, null);
  delegate.removeSubcontext(subcontext);
}

  /** {@inheritDoc} */
  @Override
  public void execute() {
    DeprecationSupport.warn(ObjectType.CLASS, this.getClass().getName(), null , ".impl");
    try {
      tool.changeKey();
    } catch (final Exception e) {
      log("Build failed", e, Project.MSG_ERR);
      throw new BuildException(e);
    }
  }
}

@Override public <T extends BaseContext> boolean containsSubcontext(@Nonnull final Class<T> clazz) {
  DeprecationSupport.warnOnce(ObjectType.CLASS, AttributeResolverWorkContext.class.getName(), null, null);
  return delegate.containsSubcontext(clazz);
}

/** {@inheritDoc} */
@Override
protected void doInitialize() throws ComponentInitializationException {
  
  for (final Map.Entry<String,String> entry : deprecatedProperties.entrySet()) {
    if (applicationContext.getEnvironment().containsProperty(entry.getKey())) {
      DeprecationSupport.warn(ObjectType.PROPERTY, entry.getKey(), null, entry.getValue());
    }
  }
  for (final String name : deadProperties) {
    if (applicationContext.getEnvironment().containsProperty(name)) {
      log.warn("property '{}' is no longer supported", name);
    }
  }
}

@Override @Nonnull public BaseContext addSubcontext(@Nonnull final BaseContext subContext) {
  DeprecationSupport.warnOnce(ObjectType.CLASS, AttributeResolverWorkContext.class.getName(), null, null);
  return delegate.addSubcontext(subContext);
}

  @Override 
  /** {@inheritDoc} */
  public void execute() {
    DeprecationSupport.warn(ObjectType.CLASS, this.getClass().getName(), null , ".impl");
    try {
      generator.generate();
    } catch (final Exception e) {
      log("Build failed", e, Project.MSG_ERR);
      throw new BuildException(e);
    }
  }
}

@Override @Nonnull public BaseContext addSubcontext(@Nonnull final BaseContext subcontext, final boolean replace) {
  DeprecationSupport.warnOnce(ObjectType.CLASS, AttributeResolverWorkContext.class.getName(), null, null);
  return delegate.addSubcontext(subcontext, replace);
}

/** {@inheritDoc} */
@Override protected void doNativeParse(@Nonnull final Element element, @Nonnull final ParserContext parserContext,
    @Nonnull final BeanDefinitionBuilder builder) {
  super.doNativeParse(element, parserContext, builder);
  
  DeprecationSupport.warn(ObjectType.XSITYPE, SCHEMA_TYPE_AFP.toString(),
      parserContext.getReaderContext().getResource().getDescription(), null);
}