io.sarl.api.naming.parser.AgentSchemeNameParser.sarl Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of api.naming Show documentation
Naming Library of the SARL SDK
The newest version!
/*
 * $Id$
 *
 * SARL is an general-purpose agent programming language.
 * More details on http://www.sarl.io
 *
 * Copyright (C) 2014-2024 SARL.io, the Original Authors and Main 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
 *
 *      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.
 */
package io.sarl.api.naming.parser

import io.sarl.api.naming.name.AgentName
import java.net.URI
import java.util.StringTokenizer
import java.util.UUID

/** 
 * Parser of agent names that is accepting URI-based syntax.
 * 
 * The different types of names are: 

 * {@code "agent:[/]{0-2}agentId[#fragmentName]"}
 * {@code "agent:[/]{0-2}contextId/agentId[#fragmentName]"}
 * {@code "agent:[/]{0-2}contextId/spaceId/agentId[#fragmentName]"}
 * 
 * 
 * @author Stéphane Galland
 * @version api.naming 0.14.0 20241106-161408
 * @mavengroupid io.sarl.sdk
 * @mavenartifactid api.naming
 * @since 0.12
 */
class AgentSchemeNameParser extends AbstractSchemeNameParser {

	/** Constructor.
	 *
	 * @optionalparam scheme the name scheme that is supported by this parser. By default it is {@link AgentName#SCHEME}.
	 */
	new (scheme : String = AgentName::SCHEME) {
		super(scheme)
	}

	@Pure
	override refactor(name : URI) : URI {
		return name.refactor(1, 3)
	}

	@Pure
	override decode(name : URI) : AgentName {
		val tokenizer = new StringTokenizer(name.path, "/")
		if (tokenizer.hasMoreTokens) {
			val token0 = tokenizer.nextToken
			if (tokenizer.hasMoreTokens) {
				val token1 = tokenizer.nextToken
				if (tokenizer.hasMoreTokens) {
					val token2 = tokenizer.nextToken
					return new AgentName(name, UUID::fromString(token0), UUID::fromString(token1),
						UUID::fromString(token2))
				}
				return new AgentName(name, UUID::fromString(token0), null, UUID::fromString(token1))
			}
			return new AgentName(name, null, null, UUID::fromString(token0))
		}
		return null
	}

}