khanh.pndc/nextcloud-docs
1
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2026-01-04 10:46:21 +07:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #5040 from nextcloud/enh/getAppFolder_is_dead

Browse Source 
getAppfolder is dead
This commit is contained in:
Roeland Jago Douma
2020-09-24 08:31:26 +02:00
committed by GitHub
parent 505c16b766 ee8b49b0d9
commit 224f72a093
1 changed files with 20 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files

58
developer_manual/basics/storage/filesystem.rst
View File

@@ -6,38 +6,8 @@ Filesystem
Because users can choose their storage backend, the filesystem should be accessed by using the appropriate filesystem classes.
Filesystem classes can be injected from the ServerContainer by calling the method **getRootFolder()**, **getUserFolder()** or **getAppFolder()**:
.. code-block:: php
<?php
namespace OCA\MyApp\AppInfo;
use \OCP\AppFramework\App;
use \OCA\MyApp\Storage\AuthorStorage;
class Application extends App {
public function __construct(array $urlParams=array()){
parent::__construct('myapp', $urlParams);
$container = $this->getContainer();
/**
* Storage Layer
*/
$container->registerService('AuthorStorage', function($c) {
return new AuthorStorage($c->query('RootStorage'));
});
$container->registerService('RootStorage', function($c) {
return $c->query('ServerContainer')->getRootFolder();
});
}
}
Filesystem classes can be injected automatically with dependency injection. This is the user filesystem.
For a simplified filestystem for app specific data see `IAppData <../appdata.html>`_
Writing to a file
-----------------
@@ -50,22 +20,28 @@ All methods return a Folder object on which files and folders can be accessed, o
<?php
namespace OCA\MyApp\Storage;
use OCP\Files\IRootFolder
class AuthorStorage {
/** @var IRootStorage */
private $storage;
public function __construct($storage){
public function __construct(IRootFolder $storage){
$this->storage = $storage;
}
public function writeTxt($content) {
$userFolder = $this->storage->getUserFolder('myUser');
// check if file exists and write to it if possible
try {
try {
$file = $this->storage->get('/myfile.txt');
$file = $userFolder->get('myfile.txt');
} catch(\OCP\Files\NotFoundException $e) {
$this->storage->touch('/myfile.txt');
$file = $this->storage->get('/myfile.txt');
$userFolder->touch('myfile.txt');
$file = $userFolder->get('myfile.txt');
}
// the id can be accessed by $file->getId();
@@ -88,18 +64,24 @@ Files and folders can also be accessed by id, by calling the **getById** method
<?php
namespace OCA\MyApp\Storage;
use OCP\Files\IRootFolder
class AuthorStorage {
/** @var IRootFolder */
private $storage;
public function __construct($storage){
public function __construct(IRootFolder $storage){
$this->storage = $storage;
}
public function getContent($id) {
$userFolder = $this->storage->getUserFolder('myUser');
// check if file exists and read from it if possible
try {
$file = $this->storage->getById($id);
$file = $userFolder->getById($id);
if($file instanceof \OCP\Files\File) {
return $file->getContent();
} else {