How to use com.owncloud.android.lib.resources.shares

/**
 * Sets or clears permission to update a folder or folder.
 *
 * @param enabled       'True' to set, 'false' to clear.
 * @return              Instance to builder itself, to allow consecutive calls to setters
 */
public SharePermissionsBuilder setUpdatePermission(boolean enabled) {
  updatePermission(OCShare.UPDATE_PERMISSION_FLAG, enabled);
  return this;
}

/**
 * Reconstruct from parcel
 * 
 * @param source The source parcel
 */    
protected OCShare(Parcel source) {
  readFromParcel(source);
}

public OCShare() {
  super();
  resetData();
}

private void fixPathForFolder(OCShare share) {
  if (share.isFolder() && share.getPath() != null && share.getPath().length() > 0 &&
      !share.getPath().endsWith(FileUtils.PATH_SEPARATOR)) {
    share.setPath(share.getPath() + FileUtils.PATH_SEPARATOR);
  }
}

private boolean isValidShare(OCShare share) {
  return (share.getRemoteId() > -1);
}

public boolean isPasswordProtected() {
  if (!ShareType.PUBLIC_LINK.equals(shareType)) {
    return isPasswordProtected;
  } else {
    return shareWith.length() > 0;
  }
}

/**
 * Parse a node, to obtain its text. Needs readText method
 * @param parser
 * @param node
 * @return Text of the node
 * @throws XmlPullParserException
 * @throws IOException
 */
private String readNode (XmlPullParser parser, String node) throws XmlPullParserException,
    IOException{
  parser.require(XmlPullParser.START_TAG, ns, node);
  String value = readText(parser);
  //Log_OC.d(TAG, "node= " + node + ", value= " + value);
  parser.require(XmlPullParser.END_TAG, ns, node);
  return value;
}

private void fixPathForFolder(OCShare share) {
  if (share.isFolder() && share.getPath() != null && share.getPath().length() > 0 &&
      !share.getPath().endsWith(FileUtils.PATH_SEPARATOR)) {
    share.setPath(share.getPath() + FileUtils.PATH_SEPARATOR);
  }
}

/**
 * Sets or clears permission to create files in share folder.
 *
 * @param enabled       'True' to set, 'false' to clear.
 * @return              Instance to builder itself, to allow consecutive calls to setters
 */
public SharePermissionsBuilder setCreatePermission(boolean enabled) {
  updatePermission(OCShare.CREATE_PERMISSION_FLAG, enabled);
  return this;
}

/**
 * Reconstruct from parcel
 *
 * @param source The source parcel
 */
protected OCShare(Parcel source) {
  readFromParcel(source);
}

public OCShare() {
  super();
  resetData();
}

private boolean isValidShare(OCShare share) {
  return (share.getRemoteId() > -1);
}

public boolean isPasswordProtected() {
  return ShareType.PUBLIC_LINK.equals(mShareType) && mShareWith.length() > 0;
}

/**
 * Parse a node, to obtain its text. Needs readText method
 * @param parser
 * @param node
 * @return Text of the node
 * @throws XmlPullParserException
 * @throws IOException
 */
private String readNode (XmlPullParser parser, String node) throws XmlPullParserException,
    IOException{
  parser.require(XmlPullParser.START_TAG, ns, node);
  String value = readText(parser);
  //Log_OC.d(TAG, "node= " + node + ", value= " + value);
  parser.require(XmlPullParser.END_TAG, ns, node);
  return value;
}

/**
 * Sets or clears permission to update a folder or folder.
 *
 * @param enabled       'True' to set, 'false' to clear.
 * @return              Instance to builder itself, to allow consecutive calls to setters
 */
public SharePermissionsBuilder setUpdatePermission(boolean enabled) {
  updatePermission(OCShare.UPDATE_PERMISSION_FLAG, enabled);
  return this;
}

/**
 * Sets or clears permission to reshare a file or folder.
 *
 * @param enabled       'True' to set, 'false' to clear.
 * @return              Instance to builder itself, to allow consecutive calls to setters
 */
public SharePermissionsBuilder setSharePermission(boolean enabled) {
  updatePermission(OCShare.SHARE_PERMISSION_FLAG, enabled);
  return this;
}

/**
 * Sets or clears permission to delete files in a shared folder.
 *
 * @param enabled       'True' to set, 'false' to clear.
 * @return              Instance to builder itself, to allow consecutive calls to setters
 */
public SharePermissionsBuilder setDeletePermission(boolean enabled) {
  updatePermission(OCShare.DELETE_PERMISSION_FLAG, enabled);
  return this;
}

/**
 * Sets or clears permission to reshare a file or folder.
 *
 * @param enabled       'True' to set, 'false' to clear.
 * @return              Instance to builder itself, to allow consecutive calls to setters
 */
public SharePermissionsBuilder setSharePermission(boolean enabled) {
  updatePermission(OCShare.SHARE_PERMISSION_FLAG, enabled);
  return this;
}

/**
 * Sets or clears permission to create files in share folder.
 *
 * @param enabled       'True' to set, 'false' to clear.
 * @return              Instance to builder itself, to allow consecutive calls to setters
 */
public SharePermissionsBuilder setCreatePermission(boolean enabled) {
  updatePermission(OCShare.CREATE_PERMISSION_FLAG, enabled);
  return this;
}

/**
 * Sets or clears permission to delete files in a shared folder.
 *
 * @param enabled       'True' to set, 'false' to clear.
 * @return              Instance to builder itself, to allow consecutive calls to setters
 */
public SharePermissionsBuilder setDeletePermission(boolean enabled) {
  updatePermission(OCShare.DELETE_PERMISSION_FLAG, enabled);
  return this;
}