/*
 * Copyright 2012-2020 the original author or authors.
 *
 * Licensed 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
 *
 *      https://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.
 */

package org.springframework.boot.origin;

import java.io.IOException;

import org.springframework.core.io.ClassPathResource;
import org.springframework.core.io.Resource;
import org.springframework.util.ObjectUtils;

Origin for an item loaded from a text resource. Provides access to the original Resource that loaded the text and a Location within it. If the provided resource provides an Origin (e.g. it is an OriginTrackedResource), then it will be used as the origin parent.
Author:Madhura Bhave, Phillip Webb
See Also:
Since:2.0.0
/** * {@link Origin} for an item loaded from a text resource. Provides access to the original * {@link Resource} that loaded the text and a {@link Location} within it. If the provided * resource provides an {@link Origin} (e.g. it is an {@link OriginTrackedResource}), then * it will be used as the {@link Origin#getParent() origin parent}. * * @author Madhura Bhave * @author Phillip Webb * @since 2.0.0 * @see OriginTrackedResource */
public class TextResourceOrigin implements Origin { private final Resource resource; private final Location location; public TextResourceOrigin(Resource resource, Location location) { this.resource = resource; this.location = location; }
Return the resource where the property originated.
Returns:the text resource or null
/** * Return the resource where the property originated. * @return the text resource or {@code null} */
public Resource getResource() { return this.resource; }
Return the location of the property within the source (if known).
Returns:the location or null
/** * Return the location of the property within the source (if known). * @return the location or {@code null} */
public Location getLocation() { return this.location; } @Override public Origin getParent() { return Origin.from(this.resource); } @Override public boolean equals(Object obj) { if (this == obj) { return true; } if (obj == null) { return false; } if (obj instanceof TextResourceOrigin) { TextResourceOrigin other = (TextResourceOrigin) obj; boolean result = true; result = result && ObjectUtils.nullSafeEquals(this.resource, other.resource); result = result && ObjectUtils.nullSafeEquals(this.location, other.location); return result; } return super.equals(obj); } @Override public int hashCode() { int result = 1; result = 31 * result + ObjectUtils.nullSafeHashCode(this.resource); result = 31 * result + ObjectUtils.nullSafeHashCode(this.location); return result; } @Override public String toString() { StringBuilder result = new StringBuilder(); result.append(getResourceDescription(this.resource)); if (this.location != null) { result.append(" - ").append(this.location); } return result.toString(); } private String getResourceDescription(Resource resource) { if (resource instanceof OriginTrackedResource) { return getResourceDescription(((OriginTrackedResource) resource).getResource()); } if (resource == null) { return "unknown resource [?]"; } if (resource instanceof ClassPathResource) { return getResourceDescription((ClassPathResource) resource); } return resource.getDescription(); } private String getResourceDescription(ClassPathResource resource) { try { JarUri jarUri = JarUri.from(resource.getURI()); if (jarUri != null) { return jarUri.getDescription(resource.getDescription()); } } catch (IOException ex) { } return resource.getDescription(); }
A location (line and column number) within the resource.
/** * A location (line and column number) within the resource. */
public static final class Location { private final int line; private final int column;
Create a new Location instance.
Params:
  • line – the line number (zero indexed)
  • column – the column number (zero indexed)
/** * Create a new {@link Location} instance. * @param line the line number (zero indexed) * @param column the column number (zero indexed) */
public Location(int line, int column) { this.line = line; this.column = column; }
Return the line of the text resource where the property originated.
Returns:the line number (zero indexed)
/** * Return the line of the text resource where the property originated. * @return the line number (zero indexed) */
public int getLine() { return this.line; }
Return the column of the text resource where the property originated.
Returns:the column number (zero indexed)
/** * Return the column of the text resource where the property originated. * @return the column number (zero indexed) */
public int getColumn() { return this.column; } @Override public boolean equals(Object obj) { if (this == obj) { return true; } if (obj == null || getClass() != obj.getClass()) { return false; } Location other = (Location) obj; boolean result = true; result = result && this.line == other.line; result = result && this.column == other.column; return result; } @Override public int hashCode() { return (31 * this.line) + this.column; } @Override public String toString() { return (this.line + 1) + ":" + (this.column + 1); } } }