org.finos.legend.sdlc.server.project.ProjectFileAccessProvider Maven / Gradle / Ivy
// Copyright 2020 Goldman Sachs
//
// 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 org.finos.legend.sdlc.server.project;
import org.finos.legend.sdlc.domain.model.project.workspace.WorkspaceType;
import org.finos.legend.sdlc.domain.model.revision.Revision;
import org.finos.legend.sdlc.domain.model.version.VersionId;
import org.finos.legend.sdlc.server.domain.api.project.source.SourceSpecification;
import org.finos.legend.sdlc.server.domain.api.project.source.WorkspaceSourceSpecification;
import org.finos.legend.sdlc.server.domain.api.workspace.WorkspaceSource;
import org.finos.legend.sdlc.server.domain.api.workspace.WorkspaceSpecification;
import org.finos.legend.sdlc.server.error.LegendSDLCServerException;
import org.finos.legend.sdlc.server.tools.IOTools;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.Reader;
import java.io.UncheckedIOException;
import java.nio.charset.StandardCharsets;
import java.time.Instant;
import java.util.Collections;
import java.util.List;
import java.util.function.Predicate;
import java.util.stream.Stream;
public interface ProjectFileAccessProvider
{
// File Access Context
interface FileAccessContext
{
/**
* Get all files as a stream. Note that this stream should be closed when
* no longer needed. It is strongly recommended to use a try-with-resources
* statement.
*
* @return stream of all files
*/
default Stream getFiles()
{
return getFilesInDirectory(ProjectPaths.ROOT_DIRECTORY);
}
/**
* Get all files in a directory as a stream. Note that this stream should be
* closed when no longer needed. It is strongly recommended to use a
* try-with-resources statement.
*
* @param directory directory path
* @return stream of all files in the given directory
*/
default Stream getFilesInDirectory(String directory)
{
return getFilesInDirectories(Collections.singletonList(directory));
}
/**
* Get all files in the directories as a stream. No file should appear multiple
* times in the stream, even if a directory appears more than once in the input.
* Note that this stream should be closed when no longer needed. It is strongly
* recommended to use a try-with-resources statement.
*
* @param directories directory paths
* @return stream of all files in the given directories
*/
Stream getFilesInDirectories(Stream directories);
/**
* Get all files in the directories as a stream. No file should appear multiple
* times in the stream, even if a directory appears more than once in the input.
* Note that this stream should be closed when no longer needed. It is strongly
* recommended to use a try-with-resources statement.
*
* @param directories directory paths
* @return stream of all files in the given directories
*/
Stream getFilesInDirectories(Iterable directories);
/**
* Get a single file. Returns null if the file does not exist.
*
* @param path file path
* @return file or null, if there is no such file
*/
ProjectFile getFile(String path);
/**
* Return whether a file exists.
*
* @param path file path
* @return whether the file exists
*/
default boolean fileExists(String path)
{
return getFile(path) != null;
}
}
/**
* A project file, comprising a path and content. The content can be accessed as
* an InputStream, a Reader, a byte array, or a String. Accessing as a Reader or
* String is only appropriate in the case of text files. By default, UTF-8 is
* used when converting between bytes and characters. Note that different
* implementations may differ in which methods of accessing the content are more
* or less efficient.
*/
interface ProjectFile
{
/**
* Path of the file with the project. The slash character ('/') is used to
* separate directories within the path. Paths will always begin with a
* slash, and will never be empty.
*
* @return file path relative to project root
*/
String getPath();
/**
* Get the content of the file as an InputStream.
*
* @return content as InputStream
*/
InputStream getContentAsInputStream();
/**
* Get the content of the file as a Reader. This is only appropriate for
* text files.
*
* @return content as Reader
*/
default Reader getContentAsReader()
{
return new InputStreamReader(getContentAsInputStream(), StandardCharsets.UTF_8);
}
/**
* Get the content of the file as a byte array.
*
* @return content as byte array
*/
default byte[] getContentAsBytes()
{
try
{
return IOTools.readAllBytes(getContentAsInputStream());
}
catch (IOException e)
{
throw new UncheckedIOException(e);
}
}
/**
* Get the content of the file as a String. This is only appropriate for
* text files.
*
* @return content as String
*/
default String getContentAsString()
{
try
{
return IOTools.readAllToString(getContentAsInputStream(), StandardCharsets.UTF_8);
}
catch (IOException e)
{
throw new UncheckedIOException(e);
}
}
}
/**
* Get a file access context. The project id and source specification must always be supplied, but revision id is
* optional.
*
* If a revision id is supplied, then the access context is for that particular revision. Otherwise, the access
* context is for the current state. Note that as the current state may change over time, calls to the access
* context may yield different results over time.
*
* @param projectId project id
* @param sourceSpecification source specification
* @param revisionId revision id (optional)
* @return access context
*/
FileAccessContext getFileAccessContext(String projectId, SourceSpecification sourceSpecification, String revisionId);
/**
* Get a file access context for the current revision. Note that as the current state may change over time, calls to
* the access context may yield different results over time.
*
* @param projectId project id
* @param sourceSpecification source specification
* @return access context
*/
default FileAccessContext getFileAccessContext(String projectId, SourceSpecification sourceSpecification)
{
return getFileAccessContext(projectId, sourceSpecification, null);
}
// Deprecated File Access APIs
@Deprecated
default FileAccessContext getProjectFileAccessContext(String projectId)
{
return getFileAccessContext(projectId, SourceSpecification.projectSourceSpecification());
}
@Deprecated
default FileAccessContext getProjectRevisionFileAccessContext(String projectId, String revisionId)
{
LegendSDLCServerException.validateNonNull(revisionId, "revisionId may not be null");
return getFileAccessContext(projectId, SourceSpecification.projectSourceSpecification(), revisionId);
}
@Deprecated
default FileAccessContext getWorkspaceFileAccessContext(String projectId, String workspaceId, WorkspaceType workspaceType, WorkspaceAccessType workspaceAccessType)
{
LegendSDLCServerException.validateNonNull(workspaceId, "workspaceId may not be null");
LegendSDLCServerException.validateNonNull(workspaceType, "workspaceType may not be null");
LegendSDLCServerException.validateNonNull(workspaceAccessType, "workspaceAccessType may not be null");
return getFileAccessContext(projectId, SourceSpecification.workspaceSourceSpecification(WorkspaceSpecification.newWorkspaceSpecification(workspaceId, workspaceType, workspaceAccessType, WorkspaceSource.projectWorkspaceSource())));
}
@Deprecated
default FileAccessContext getWorkspaceRevisionFileAccessContext(String projectId, String workspaceId, WorkspaceType workspaceType, WorkspaceAccessType workspaceAccessType, String revisionId)
{
LegendSDLCServerException.validateNonNull(workspaceId, "workspaceId may not be null");
LegendSDLCServerException.validateNonNull(workspaceType, "workspaceType may not be null");
LegendSDLCServerException.validateNonNull(workspaceAccessType, "workspaceAccessType may not be null");
LegendSDLCServerException.validateNonNull(revisionId, "revisionId may not be null");
return getFileAccessContext(projectId, SourceSpecification.workspaceSourceSpecification(WorkspaceSpecification.newWorkspaceSpecification(workspaceId, workspaceType, workspaceAccessType, WorkspaceSource.projectWorkspaceSource())), revisionId);
}
@Deprecated
default FileAccessContext getFileAccessContext(String projectId, String workspaceId, WorkspaceAccessType workspaceAccessType, String revisionId)
{
return getFileAccessContext(projectId, workspaceId, WorkspaceType.USER, workspaceAccessType, revisionId);
}
/**
* Get a file access context. The project id must always be supplied, but workspace
* and revision ids are optional. If workspace is specified, workspace access type is also required
*
* If a workspace id is supplied, then the access context is for that workspace.
* Otherwise, it is for the trunk or master branch of the project.
*
* If a revision id is supplied, then the access context is for that particular
* revision of the project or workspace. Otherwise, the access context is for
* the current state of the project or workspace. Note that as the current
* state may change over time, calls to the access context may yield different
* results over time.
*
* @param projectId project id
* @param workspaceId workspace id (optional)
* @param workspaceType type for the workspace (e.g. user, group) (optional)
* @param workspaceAccessType access type for the workspace (e.g. conflict resolution, backup) (optional)
* @param revisionId revision id (optional)
* @return access context
*/
@Deprecated
default FileAccessContext getFileAccessContext(String projectId, String workspaceId, WorkspaceType workspaceType, WorkspaceAccessType workspaceAccessType, String revisionId)
{
return getFileAccessContext(projectId, SourceSpecification.newSourceSpecification(workspaceId, workspaceType, workspaceAccessType), revisionId);
}
/**
* Get a file access context for a version of a project. Both the project and
* version ids must be supplied.
*
* @param projectId project id
* @param versionId version id
* @return access context
*/
@Deprecated
default FileAccessContext getFileAccessContext(String projectId, VersionId versionId)
{
return getFileAccessContext(projectId, SourceSpecification.versionSourceSpecification(versionId));
}
// Revision Access Context
interface RevisionAccessContext
{
Revision getBaseRevision();
Revision getCurrentRevision();
Revision getRevision(String revisionId);
Stream getAllRevisions(Predicate predicate, Instant since, Instant until, Integer limit);
}
/**
* Get a revision access context. The project id and source specification must always be supplied, but the paths are
* optional. If paths are supplied, then the revision access context is for those paths. The paths can be either
* file or directory paths. They should use the slash character ('/') to separate directories, and should all start
* with a slash.
*
* @param projectId project id
* @param sourceSpecification source specification
* @param paths file or directory paths (optional)
* @return revision access context
*/
RevisionAccessContext getRevisionAccessContext(String projectId, SourceSpecification sourceSpecification, Iterable paths);
/**
* Get a revision access context.
*
* @param projectId project id
* @param sourceSpecification source specification
* @return revision access context
*/
default RevisionAccessContext getRevisionAccessContext(String projectId, SourceSpecification sourceSpecification)
{
return getRevisionAccessContext(projectId, sourceSpecification, null);
}
// Deprecated Revision Access APIs
@Deprecated
default RevisionAccessContext getProjectRevisionAccessContext(String projectId)
{
return getRevisionAccessContext(projectId, SourceSpecification.projectSourceSpecification(), null);
}
@Deprecated
default RevisionAccessContext getProjectPathRevisionAccessContext(String projectId, String path)
{
LegendSDLCServerException.validateNonNull(path, "path may not be null");
return getRevisionAccessContext(projectId, SourceSpecification.projectSourceSpecification(), Collections.singleton(path));
}
@Deprecated
default RevisionAccessContext getWorkspaceRevisionAccessContext(String projectId, String workspaceId, WorkspaceType workspaceType, WorkspaceAccessType workspaceAccessType)
{
LegendSDLCServerException.validateNonNull(workspaceId, "workspaceId may not be null");
LegendSDLCServerException.validateNonNull(workspaceType, "workspaceType may not be null");
LegendSDLCServerException.validateNonNull(workspaceAccessType, "workspaceAccessType may not be null");
return getRevisionAccessContext(projectId, SourceSpecification.workspaceSourceSpecification(WorkspaceSpecification.newWorkspaceSpecification(workspaceId, workspaceType, workspaceAccessType)), null);
}
@Deprecated
default RevisionAccessContext getWorkspaceRevisionAccessContext(String projectId, SourceSpecification sourceSpecification)
{
LegendSDLCServerException.validate(sourceSpecification, spec -> spec instanceof WorkspaceSourceSpecification, "source specification must be a workspace source specification");
return getRevisionAccessContext(projectId, sourceSpecification, null);
}
@Deprecated
default RevisionAccessContext getWorkspacePathRevisionAccessContext(String projectId, String workspaceId, WorkspaceType workspaceType, WorkspaceAccessType workspaceAccessType, String path)
{
LegendSDLCServerException.validateNonNull(workspaceId, "workspaceId may not be null");
LegendSDLCServerException.validateNonNull(workspaceType, "workspaceType may not be null");
LegendSDLCServerException.validateNonNull(workspaceAccessType, "workspaceAccessType may not be null");
LegendSDLCServerException.validateNonNull(path, "path may not be null");
return getRevisionAccessContext(projectId, SourceSpecification.workspaceSourceSpecification(WorkspaceSpecification.newWorkspaceSpecification(workspaceId, workspaceType, workspaceAccessType)), Collections.singleton(path));
}
@Deprecated
default RevisionAccessContext getWorkspacePathsRevisionAccessContext(String projectId, String workspaceId, WorkspaceType workspaceType, WorkspaceAccessType workspaceAccessType, Iterable paths)
{
LegendSDLCServerException.validateNonNull(workspaceId, "workspaceId may not be null");
LegendSDLCServerException.validateNonNull(workspaceAccessType, "workspaceAccessType may not be null");
LegendSDLCServerException.validateNonNull(paths, "paths may not be null");
return getRevisionAccessContext(projectId, SourceSpecification.workspaceSourceSpecification(WorkspaceSpecification.newWorkspaceSpecification(workspaceId, workspaceType, workspaceAccessType)), paths);
}
@Deprecated
default RevisionAccessContext getVersionRevisionAccessContext(String projectId, VersionId versionId)
{
return getRevisionAccessContext(projectId, SourceSpecification.versionSourceSpecification(versionId), null);
}
@Deprecated
default RevisionAccessContext getVersionPathRevisionAccessContext(String projectId, VersionId versionId, String path)
{
LegendSDLCServerException.validateNonNull(path, "path may not be null");
return getRevisionAccessContext(projectId, SourceSpecification.versionSourceSpecification(versionId), Collections.singleton(path));
}
@Deprecated
default RevisionAccessContext getVersionPathRevisionAccessContext(String projectId, VersionId versionId, Iterable paths)
{
LegendSDLCServerException.validateNonNull(paths, "paths may not be null");
return getRevisionAccessContext(projectId, SourceSpecification.versionSourceSpecification(versionId), paths);
}
/**
* Get a revision access context for a version of a project. Both the project id and
* version id must be supplied.
*
* @param projectId project id
* @param versionId version id
* @return revision access context
*/
@Deprecated
default RevisionAccessContext getRevisionAccessContext(String projectId, VersionId versionId)
{
return getRevisionAccessContext(projectId, SourceSpecification.versionSourceSpecification(versionId), null);
}
/**
* Get a revision access context for a version of a project. Both the project id and version id must be supplied,
* but path is optional.
*
* If path is supplied, then the revision access context is for that path. The path can be either a file or
* directory path. It should use the slash character ('/') to separate directories, and it should start with a
* slash.
*
* @param projectId project id
* @param versionId version id
* @param path file or directory path (optional)
* @return revision access context
*/
@Deprecated
default RevisionAccessContext getRevisionAccessContext(String projectId, VersionId versionId, String path)
{
return getRevisionAccessContext(projectId, SourceSpecification.versionSourceSpecification(versionId), (path == null) ? null : Collections.singleton(path));
}
/**
* Get a revision access context for a version of a project. Both the project id and version id must be supplied,
* but paths is optional.
*
* If paths is supplied, then the revision access context is for that set of paths. The paths can be either file or
* directory paths. They should use the slash character ('/') to separate directories, and should all start with a
* slash.
*
* @param projectId project id
* @param versionId version id
* @param paths file or directory paths (optional)
* @return revision access context
*/
@Deprecated
default RevisionAccessContext getRevisionAccessContext(String projectId, VersionId versionId, Iterable paths)
{
return getRevisionAccessContext(projectId, SourceSpecification.versionSourceSpecification(versionId), paths);
}
/**
* Get a revision access context. The project id must always be supplied, but workspace id is optional. If
* workspace id is specified, workspace access type must also be specified.
*
* If a workspace id is supplied, then the revision access context is for that workspace. Otherwise, it is for the
* trunk or master branch of the project.
*
* @param projectId project id
* @param workspaceId workspace id (optional)
* @param workspaceType type for the workspace (e.g. user, group)
* @param workspaceAccessType access type for the workspace (e.g. conflict resolution, backup)
* @return revision access context
*/
@Deprecated
default RevisionAccessContext getRevisionAccessContext(String projectId, String workspaceId, WorkspaceType workspaceType, WorkspaceAccessType workspaceAccessType)
{
return getRevisionAccessContext(projectId, SourceSpecification.newSourceSpecification(workspaceId, workspaceType, workspaceAccessType), null);
}
/**
* Get a revision access context. The project id must always be supplied, but workspace id and path are optional.
* If workspace id is specified, workspace access type must also be specified.
*
* If a workspace id is supplied, then the revision access context is for that workspace. Otherwise, it is for the
* trunk or master branch of the project.
*
* If path is supplied, then the revision access context is for that path. The path can be either a file or
* directory path. It should use the slash character ('/') to separate directories, and it should start with a
* slash.
*
* @param projectId project id
* @param workspaceId workspace id (optional)
* @param workspaceType type for the workspace (e.g. user, group)
* @param workspaceAccessType access type for the workspace (e.g. conflict resolution, backup)
* @param path file or directory path (optional)
* @return revision access context
*/
@Deprecated
default RevisionAccessContext getRevisionAccessContext(String projectId, String workspaceId, WorkspaceType workspaceType, WorkspaceAccessType workspaceAccessType, String path)
{
return getRevisionAccessContext(projectId, SourceSpecification.newSourceSpecification(workspaceId, workspaceType, workspaceAccessType), (path == null) ? null : Collections.singleton(path));
}
// File Modification Context
interface FileModificationContext
{
Revision submit(String message, List operations);
}
/**
* Get a modification context. The project id and source specification must always be supplied, but revision id is
* optional. If a revision id is supplied, it is used to validate the current revision before making any
* modifications. Note that not all source specifications need be supported for modification.
*
* @param projectId project id
* @param sourceSpecification source specification
* @param revisionId revision id (optional, for validation)
* @return modification context
* @throws UnsupportedOperationException if the source specification is not supported for modification
*/
FileModificationContext getFileModificationContext(String projectId, SourceSpecification sourceSpecification, String revisionId);
/**
* Get a modification context.
*
* @param projectId project id
* @param sourceSpecification source specification
* @return modification context
* @throws UnsupportedOperationException if the source specification is not supported for modification
*/
default FileModificationContext getFileModificationContext(String projectId, SourceSpecification sourceSpecification)
{
return getFileModificationContext(projectId, sourceSpecification, null);
}
@Deprecated
default FileModificationContext getProjectFileModificationContext(String projectId)
{
return getFileModificationContext(projectId, SourceSpecification.projectSourceSpecification(), null);
}
@Deprecated
default FileModificationContext getProjectFileModificationContext(String projectId, String revisionId)
{
LegendSDLCServerException.validateNonNull(revisionId, "revisionId may not be null");
return getFileModificationContext(projectId, SourceSpecification.projectSourceSpecification(), revisionId);
}
@Deprecated
default FileModificationContext getWorkspaceFileModificationContext(String projectId, String workspaceId, WorkspaceType workspaceType, WorkspaceAccessType workspaceAccessType)
{
LegendSDLCServerException.validateNonNull(workspaceId, "workspaceId may not be null");
LegendSDLCServerException.validateNonNull(workspaceType, "workspaceType may not be null");
LegendSDLCServerException.validateNonNull(workspaceAccessType, "workspaceAccessType may not be null");
return getFileModificationContext(projectId, SourceSpecification.newSourceSpecification(workspaceId, workspaceType, workspaceAccessType), null);
}
@Deprecated
default FileModificationContext getWorkspaceFileModificationContext(String projectId, String workspaceId, WorkspaceType workspaceType, WorkspaceAccessType workspaceAccessType, String revisionId)
{
LegendSDLCServerException.validateNonNull(workspaceId, "workspaceId may not be null");
LegendSDLCServerException.validateNonNull(workspaceType, "workspaceType may not be null");
LegendSDLCServerException.validateNonNull(workspaceAccessType, "workspaceAccessType may not be null");
LegendSDLCServerException.validateNonNull(revisionId, "revisionId may not be null");
return getFileModificationContext(projectId, SourceSpecification.newSourceSpecification(workspaceId, workspaceType, workspaceAccessType), revisionId);
}
@Deprecated
default FileModificationContext getFileModificationContext(String projectId, String workspaceId, WorkspaceAccessType workspaceAccessType, String revisionId)
{
return getFileModificationContext(projectId, workspaceId, WorkspaceType.USER, workspaceAccessType, revisionId);
}
@Deprecated
default FileModificationContext getFileModificationContext(String projectId, String workspaceId, WorkspaceType workspaceType, WorkspaceAccessType workspaceAccessType, String revisionId)
{
return getFileModificationContext(projectId, SourceSpecification.newSourceSpecification(workspaceId, workspaceType, workspaceAccessType), revisionId);
}
enum WorkspaceAccessType
{
WORKSPACE("workspace", "workspaces"),
CONFLICT_RESOLUTION("workspace with conflict resolution", "workspaces with conflict resolution"),
BACKUP("backup workspace", "backup workspaces");
private final String label;
private final String labelPlural;
WorkspaceAccessType(final String label, final String labelPlural)
{
this.label = label;
this.labelPlural = labelPlural;
}
public String getLabel()
{
return this.label;
}
public String getLabelPlural()
{
return this.labelPlural;
}
}
}