tonic::FileLoader Class Reference

#include <file_loader.h>

Public Member Functions
	FileLoader (int dirfd=-1)
	~FileLoader ()
bool	LoadPackagesMap (const std::string &packages)
const std::string &	packages () const
Dart_Handle	HandleLibraryTag (Dart_LibraryTag tag, Dart_Handle library, Dart_Handle url)
Dart_Handle	CanonicalizeURL (Dart_Handle library, Dart_Handle url)
Dart_Handle	Import (Dart_Handle url)
Dart_Handle	Kernel (Dart_Handle url)
void	SetPackagesUrl (Dart_Handle url)
Dart_Handle	FetchBytes (const std::string &url, uint8_t *&buffer, intptr_t &buffer_size)

Static Public Attributes
static const char	kFileURLPrefix [] = "file://"
static const size_t	kFileURLPrefixLength
static const std::string	kPathSeparator = "/"

Detailed Description

Definition at line 19 of file file_loader.h.

Constructor & Destructor Documentation

FileLoader()

tonic::FileLoader::FileLoader ( int  dirfd = -1 )

explicit

Definition at line 49 of file file_loader.cc.

: dirfd_(dirfd) {}

~FileLoader()

tonic::FileLoader::~FileLoader

(

)

Definition at line 51 of file file_loader.cc.

                        {
  for (auto kernel_buffer : kernel_buffers_)
    free(kernel_buffer);
 
  if (dirfd_ >= 0)
    close(dirfd_);
}

Member Function Documentation

CanonicalizeURL()

Dart_Handle tonic::FileLoader::CanonicalizeURL	(	Dart_Handle	library,
		Dart_Handle	url
	)

Definition at line 133 of file file_loader.cc.

                                                                            {
  std::string string = StdStringFromDart(url);
  if (string.find(kDartScheme) == 0u)
    return url;
  if (string.find(kPackageScheme) == 0u)
    return StdStringToDart(SanitizePath(string));
 
  if (string.find(kFileScheme) == 0u) {
    return StdStringToDart(SanitizeURIEscapedCharacters(string));
  }
 
  std::string library_url = StdStringFromDart(Dart_LibraryUrl(library));
  std::string prefix = ExtractSchemePrefix(library_url);
  std::string base_path = ExtractPath(library_url);
  std::string simplified_path =
      filesystem::SimplifyPath(filesystem::GetDirectoryName(base_path) +
                               FileLoader::kPathSeparator + string);
  return StdStringToDart(SanitizePath(prefix + simplified_path));
}

References filesystem::GetDirectoryName(), kPathSeparator, filesystem::SimplifyPath(), tonic::StdStringFromDart(), and tonic::StdStringToDart().

Referenced by HandleLibraryTag().

FetchBytes()

Dart_Handle tonic::FileLoader::FetchBytes	(	const std::string &	url,
		uint8_t *&	buffer,
		intptr_t &	buffer_size
	)

Definition at line 161 of file file_loader.cc.

                                                          {
  buffer = nullptr;
  buffer_size = -1;
 
  std::string path = filesystem::SimplifyPath(GetFilePathForURL(url));
  if (path.empty()) {
    std::string error_message = "error: Unable to read '" + url + "'.";
    return Dart_NewUnhandledExceptionError(
        Dart_NewStringFromCString(error_message.c_str()));
  }
  std::string absolute_path = filesystem::GetAbsoluteFilePath(path);
  auto result = filesystem::ReadFileToBytes(absolute_path);
  if (result.first == nullptr) {
    std::string error_message =
        "error: Unable to read '" + absolute_path + "'.";
    return Dart_NewUnhandledExceptionError(
        Dart_NewStringFromCString(error_message.c_str()));
  }
  buffer = result.first;
  buffer_size = result.second;
  return Dart_True();
}

References filesystem::GetAbsoluteFilePath(), filesystem::ReadFileToBytes(), and filesystem::SimplifyPath().

Referenced by Import(), and Kernel().

HandleLibraryTag()

Dart_Handle tonic::FileLoader::HandleLibraryTag	(	Dart_LibraryTag	tag,
		Dart_Handle	library,
		Dart_Handle	url
	)

Definition at line 118 of file file_loader.cc.

                                                          {
  TONIC_DCHECK(Dart_IsNull(library) || Dart_IsLibrary(library) ||
               Dart_IsString(library));
  TONIC_DCHECK(Dart_IsString(url));
  if (tag == Dart_kCanonicalizeUrl)
    return CanonicalizeURL(library, url);
  if (tag == Dart_kKernelTag)
    return Kernel(url);
  if (tag == Dart_kImportTag)
    return Import(url);
  return Dart_NewApiError("Unknown library tag.");
}

References CanonicalizeURL(), Import(), Kernel(), and TONIC_DCHECK.

Referenced by tonic::DartState::HandleLibraryTag().

Import()

Dart_Handle tonic::FileLoader::Import

(

Dart_Handle

url

)

Definition at line 186 of file file_loader.cc.

                                              {
  std::string url_string = StdStringFromDart(url);
  uint8_t* buffer = nullptr;
  intptr_t buffer_size = -1;
  Dart_Handle result = FetchBytes(url_string, buffer, buffer_size);
  if (Dart_IsError(result)) {
    return result;
  }
  // The embedder must keep the buffer alive until isolate shutdown.
  kernel_buffers_.push_back(buffer);
  return Dart_LoadLibraryFromKernel(buffer, buffer_size);
}

References FetchBytes(), and tonic::StdStringFromDart().

Referenced by HandleLibraryTag().

Kernel()

Dart_Handle tonic::FileLoader::Kernel

(

Dart_Handle

url

)

Definition at line 205 of file file_loader.cc.

                                              {
  std::string url_string = StdStringFromDart(url);
  uint8_t* buffer = nullptr;
  intptr_t buffer_size = -1;
  Dart_Handle result = FetchBytes(url_string, buffer, buffer_size);
  if (Dart_IsError(result)) {
    return result;
  }
  result =
      Dart_NewExternalTypedData(Dart_TypedData_kUint8, buffer, buffer_size);
  Dart_NewFinalizableHandle(result, buffer, buffer_size, MallocFinalizer);
  return result;
}

References FetchBytes(), and tonic::StdStringFromDart().

Referenced by HandleLibraryTag().

LoadPackagesMap()

bool tonic::FileLoader::LoadPackagesMap

(

const std::string &

packages

)

Definition at line 79 of file file_loader.cc.

                                                          {
  packages_ = packages;
  std::string packages_source;
  if (!ReadFileToString(packages_, &packages_source)) {
    tonic::Log("error: Unable to load .packages file '%s'.", packages_.c_str());
    return false;
  }
  packages_map_.reset(new PackagesMap());
  std::string error;
  if (!packages_map_->Parse(packages_source, &error)) {
    tonic::Log("error: Unable to parse .packages file '%s'. %s",
               packages_.c_str(), error.c_str());
    return false;
  }
  return true;
}

References error, tonic::Log(), and packages().

Referenced by SetPackagesUrl().

packages()

const std::string & tonic::FileLoader::packages ( ) const

inline

Definition at line 27 of file file_loader.h.

{ return packages_; }

Referenced by LoadPackagesMap(), and SetPackagesUrl().

SetPackagesUrl()

void tonic::FileLoader::SetPackagesUrl

(

Dart_Handle

url

)

Definition at line 220 of file file_loader.cc.

                                               {
  if (url == Dart_Null()) {
    // No packages url specified.
    LoadPackagesMap(packages());
    return;
  }
  const std::string& packages_url = StdStringFromDart(url);
  LoadPackagesMap(packages_url);
}

References LoadPackagesMap(), packages(), and tonic::StdStringFromDart().

Member Data Documentation

kFileURLPrefix

const char tonic::FileLoader::kFileURLPrefix = "file://"

static

Definition at line 42 of file file_loader.h.

kFileURLPrefixLength

const size_t tonic::FileLoader::kFileURLPrefixLength

static

Initial value:

=
    sizeof(FileLoader::kFileURLPrefix) - 1

Definition at line 43 of file file_loader.h.

kPathSeparator

const std::string tonic::FileLoader::kPathSeparator = "/"

static

Definition at line 44 of file file_loader.h.

Referenced by CanonicalizeURL().

---

The documentation for this class was generated from the following files:

• third_party/tonic/file_loader/file_loader.h
• third_party/tonic/file_loader/file_loader.cc
• third_party/tonic/file_loader/file_loader_fuchsia.cc
• third_party/tonic/file_loader/file_loader_posix.cc
• third_party/tonic/file_loader/file_loader_win.cc