Module com.darkcollective.relix.lang.ast

Package com.darkcollective.relix.lang.ast

Record Class ImportStatement

java.lang.Object

java.lang.Record

com.darkcollective.relix.lang.ast.ImportStatement

Record Components:

kind - the declared import kind; ImportKind.BULK when no names are specified

names - the symbols to import; empty for ImportKind.BULK

sourcePath - the file path of the target .relix file; must not be blank

location - the source location of this statement; never null

All Implemented Interfaces:

Statement

public record ImportStatement(ImportKind kind, List<String> names, String sourcePath, SourceLocation location)
extends Record
implements Statement

An import statement — brings symbols from another .relix file into the current namespace.

Syntax forms and their resulting records:

   import './common.relix';
   → ImportStatement(BULK, [], "./common.relix")

   import { Users, Orders } from './db.relix';
   → ImportStatement(UNQUALIFIED, ["Users","Orders"], "./db.relix")

   import source current_weather from './weather-api.relix';
   → ImportStatement(SOURCE, ["current_weather"], "./weather-api.relix")

   import relation Users, Orders from './db.relix';
   → ImportStatement(RELATION, ["Users","Orders"], "./db.relix")

   import function tax, discount from './calc.relix';
   → ImportStatement(FUNCTION, ["tax","discount"], "./calc.relix")
 

The sourcePath is always relative to the importing file's directory. Circular import detection is handled by the semantic layer.

Constructor Summary

Constructors

Constructor	Description
ImportStatement(ImportKind kind, List<String> names, String sourcePath)	Convenience constructor for tests; uses SourceLocation.UNKNOWN.
ImportStatement(ImportKind kind, List<String> names, String sourcePath, SourceLocation location)	Creates an instance of a ImportStatement record class.

Method Summary

Modifier and Type	Method	Description
final boolean	equals(Object o)	Indicates whether some other object is "equal to" this one.
final int	hashCode()	Returns a hash code value for this object.
ImportKind	kind()	Returns the value of the kind record component.
SourceLocation	location()	Returns the value of the location record component.
List<String>	names()	Returns the value of the names record component.
String	sourcePath()	Returns the value of the sourcePath record component.
final String	toString()	Returns a string representation of this record class.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

ImportStatement

public ImportStatement(ImportKind kind,
 List<String> names,
 String sourcePath,
 SourceLocation location)

Creates an instance of a ImportStatement record class.

Parameters:

kind - the value for the kind record component

names - the value for the names record component

sourcePath - the value for the sourcePath record component

location - the value for the location record component

ImportStatement

public ImportStatement(ImportKind kind,
 List<String> names,
 String sourcePath)

Convenience constructor for tests; uses SourceLocation.UNKNOWN.

Method Details

toString

public final String toString()

Returns a string representation of this record class. The representation contains the name of the class, followed by the name and value of each of the record components.

Specified by:

toString in class Record

Returns:

a string representation of this object

hashCode

public final int hashCode()

Returns a hash code value for this object. The value is derived from the hash code of each of the record components.

Specified by:

hashCode in class Record

Returns:

a hash code value for this object

equals

public final boolean equals(Object o)

Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal. All components in this record class are compared with Objects::equals(Object,Object).

Specified by:

equals in class Record

Parameters:

o - the object with which to compare

Returns:

true if this object is the same as the o argument; false otherwise.

kind

public ImportKind kind()

Returns the value of the kind record component.

Returns:

the value of the kind record component

names

public List<String> names()

Returns the value of the names record component.

Returns:

the value of the names record component

sourcePath

public String sourcePath()

Returns the value of the sourcePath record component.

Returns:

the value of the sourcePath record component

location

public SourceLocation location()

Returns the value of the location record component.

Specified by:

location in interface Statement

Returns:

the value of the location record component