INamespace (General SQL Parser Java Library Core 4.1.0.5 API)

All Known Implementing Classes:

AbstractNamespace, CTENamespace, DynamicStarSource, OraclePackageNamespace, PivotNamespace, PlsqlVariableNamespace, SubqueryNamespace, TableNamespace, UnionNamespace, UnnestNamespace, ValuesNamespace
```
public interface INamespace
```
Represents a namespace that exposes columns. A namespace can be a table, subquery, CTE, etc. Key responsibilities: 1. Provide column existence checks (hasColumn) 2. Resolve column names to ColumnSource 3. Support SELECT * expansion 4. Track data lineage (getFinalTable) Design based on Apache Calcite's SqlValidatorNamespace

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`default boolean`	`addInferredColumn(String columnName, double confidence, String evidence)` Add an inferred column to this namespace.
`Map<String,ColumnSource>`	`getAllColumnSources()` Get all column sources exposed by this namespace.
`List<TTable>`	`getAllFinalTables()` Get all final physical tables this namespace depends on.
`String`	`getDisplayName()` Get a display name for this namespace (for debugging/error messages)
`TTable`	`getFinalTable()` Get the final physical table this namespace represents.
`default Set<String>`	`getInferredColumns()` Get all columns that were inferred (not from SELECT list directly).
`Object`	`getNode()` Get the associated AST node (TTable, TSelectSqlStatement, etc.)
`default TSelectSqlStatement`	`getSelectStatement()` Get the underlying SELECT statement for this namespace.
`default TTable`	`getSourceTable()` Get the TTable that this namespace is associated with.
`default TResultColumn`	`getStarColumn()` Get the star column (SELECT *) from this namespace if one exists.
`ColumnLevel`	`hasColumn(String columnName)` Check if a column exists in this namespace.
`default boolean`	`hasStarColumn()` Check if this namespace contains a star column (SELECT *).
`boolean`	`isValidated()` Check if this namespace is validated/resolved.
`ColumnSource`	`resolveColumn(String columnName)` Resolve a column name to its source.
`default ColumnSource`	`resolveColumnPath(List<String> path)` Resolve a column path (column.field.subfield...) to its source.
`default boolean`	`supportsDynamicInference()` Check if this namespace supports dynamic column inference.
`void`	`validate()` Validate/resolve this namespace.

- Method Detail
  - getDisplayName
```
String getDisplayName()
```
    Get a display name for this namespace (for debugging/error messages)
  - hasColumn
```
ColumnLevel hasColumn(String columnName)
```
    Check if a column exists in this namespace. Returns a three-level answer: EXISTS, MAYBE, NOT_EXISTS
    
    Parameters:
    
    columnName - Column name to check
    
    Returns:
    
    Column existence level
  - resolveColumn
```
ColumnSource resolveColumn(String columnName)
```
    Resolve a column name to its source.
    
    Parameters:
    
    columnName - Column name to resolve
    
    Returns:
    
    ColumnSource if found, null otherwise
  - resolveColumnPath
```
default ColumnSource resolveColumnPath(List<String> path)
```
    Resolve a column path (column.field.subfield...) to its source.
    This method supports deep/record field access patterns like customer.address.city where:
    - path[0] is the base column name (e.g., "customer")
    - path[1..n] are field paths (e.g., ["address", "city"])
    Parameters:
    
    path - The column path segments
    
    Returns:
    
    ColumnSource with fieldPath set, or null if base column not found
  - getAllColumnSources
```
Map<String,ColumnSource> getAllColumnSources()
```
    Get all column sources exposed by this namespace. Used for SELECT * expansion and smart completion.
    
    Returns:
    
    Map of column name -> ColumnSource
  - getFinalTable
```
TTable getFinalTable()
```
    Get the final physical table this namespace represents. For tables: returns the table itself For subqueries/CTEs: recursively traces back to physical table(s)
    
    Returns:
    
    Physical table, or null if not determinable
  - getAllFinalTables
```
List<TTable> getAllFinalTables()
```
    Get all final physical tables this namespace depends on. For simple table namespace: returns single table For subquery/CTE: returns all tables in the query tree
    
    Returns:
    
    List of all physical tables
  - isValidated
```
boolean isValidated()
```
    Check if this namespace is validated/resolved. Some namespaces require resolution before they can provide column info.
    
    Returns:
    
    true if validated
  - validate
```
void validate()
```
    Validate/resolve this namespace. For subqueries: resolve the SELECT list For tables: load metadata if needed
  - getNode
```
Object getNode()
```
    Get the associated AST node (TTable, TSelectSqlStatement, etc.)
    
    Returns:
    
    AST node, or null if not applicable
  - getSelectStatement
```
default TSelectSqlStatement getSelectStatement()
```
    Get the underlying SELECT statement for this namespace. For CTENamespace: returns the CTE's subquery For SubqueryNamespace: returns the subquery For TableNamespace: returns null
    
    Returns:
    
    the SELECT statement, or null if not applicable
  - hasStarColumn
```
default boolean hasStarColumn()
```
    Check if this namespace contains a star column (SELECT *). Used to identify namespaces that may need star column inference.
    
    Returns:
    
    true if the namespace has SELECT *, false otherwise
  - addInferredColumn
```
default boolean addInferredColumn(String columnName,
                                  double confidence,
                                  String evidence)
```
    Add an inferred column to this namespace. Used by star column push-down to add columns discovered from outer queries.
    
    Parameters:
    
    columnName - the column name to add
    
    confidence - the confidence score (0.0 to 1.0)
    
    evidence - description of why this column was inferred
    
    Returns:
    
    true if the column was added, false if already exists
  - getInferredColumns
```
default Set<String> getInferredColumns()
```
    Get all columns that were inferred (not from SELECT list directly). These are columns discovered through star column push-down.
    
    Returns:
    
    set of inferred column names, empty if none
  - supportsDynamicInference
```
default boolean supportsDynamicInference()
```
    Check if this namespace supports dynamic column inference. DynamicStarSource and similar namespaces return true.
    
    Returns:
    
    true if this namespace can have columns added dynamically
  - getStarColumn
```
default TResultColumn getStarColumn()
```
    Get the star column (SELECT *) from this namespace if one exists. Used to track the sourceColumn for columns inferred from a star.
    
    Returns:
    
    The star column TResultColumn, or null if no star column exists
  - getSourceTable
```
default TTable getSourceTable()
```
    Get the TTable that this namespace is associated with. Used for legacy sync to set TObjectName.sourceTable. For TableNamespace: returns the table itself For SubqueryNamespace: returns the TTable wrapping the subquery For CTENamespace: returns the CTE referencing table For others: returns null
    
    Returns:
    
    The source TTable, or null if not applicable

Interface INamespace

Method Summary

Method Detail

getDisplayName

hasColumn

resolveColumn

resolveColumnPath

getAllColumnSources

getFinalTable

getAllFinalTables

isValidated

validate

getNode

getSelectStatement

hasStarColumn

addInferredColumn

getInferredColumns

supportsDynamicInference

getStarColumn

getSourceTable