* KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */
package org.apache.maven.api.services.xml;

public interface Location {

    /**
     * Return the line number where the current event ends,
     * returns -1 if none is available.
     * @return the current line number
     */
    int getLineNumber();

    /**

     *
     * @param location the API model InputLocation to convert from
     */
    public InputLocation(org.apache.maven.api.model.InputLocation location) {
        this.lineNumber = location.getLineNumber();
        this.columnNumber = location.getColumnNumber();
        this.source = location.getSource() != null ? new InputSource(location.getSource()) : null;
        this.locations = location.getLocations().isEmpty()

            InputLocation location = profile.getLocation("");
            assertNotNull(location, "Profile location should not be null for profile: " + profile.getId());
            assertTrue(
                    location.getLineNumber() > 0,
                    "Profile location line number should be positive, but was: " + location.getLineNumber()

        }

        if (!reportSet.getReports().isEmpty()) {
            InputLocation location = reportSet.getLocation("reports");
            Xpp3Dom reports = new Xpp3Dom("reports", location);
            int n = 0;
            for (String report : reportSet.getReports()) {
                addDom(reports, "report", report, (location == null) ? null : location.getLocation(n++));
            }
            dom.addChild(reports);
        }

         * Constructs a new PathSource with the specified path and location.
         *
         * @param path the filesystem path to the source content
         * @param location the logical location of the source, used for reporting purposes.
         *                 If null, the path string representation is used
         */
        protected PathSource(Path path, String location) {
            this.path = requireNonNull(path, "path").normalize();

     * </ul>
     *
     * @param modelLocator the locator to use for finding the related POM file
     * @param relative the relative path to resolve
     * @return a new ModelSource for the resolved POM, or null if:
     *         <ul>
     *           <li>This is not a build source</li>
     *           <li>No POM can be found at the resolved location</li>
     *         </ul>

            if (st.countTokens() > 0) {
                String location;
                do {
                    location = nextLocation(st);
                    if (location != null) {
                        boolean mandatory = true;
                        if (location.startsWith("?")) {
                            mandatory = false;
                            location = location.substring(1);
                        }

        this.caption = caption;
    }

    /**
     * Gets the geographic location of the image.
     * @return the geographic location
     */
    public String getGeoLocation() {
        return geoLocation;
    }

    /**
     * Sets the geographic location of the image.
     * @param geoLocation the geographic location to set
     */
    public void setGeoLocation(final String geoLocation) {

        return this.modelId;
    } // -- String getModelId()

    /**
     * Set the path/URL of the POM or {@code null} if unknown.
     *
     * @param location
     */
    public void setLocation(String location) {
        this.location = location;
    } // -- void setLocation( String )

    /**
     * Set the identifier of the POM in the format {@code
     * <groupId>:<artifactId>:<version>}.
     *

                        if (!location.isEmpty()) {
                            location += ", ";
                        }
                        location += "column " + problem.getColumnNumber();
                    }

                    if (!location.isEmpty()) {
                        buffer.append(" @ ").append(location);
                    }
                    buffer.append("\n");