/**
   * Create a stub for a getter of the given field using getter/setter templates. The resulting code
   * has to be formatted and indented.
   *
   * @param field The field to create a getter for
   * @param setterName The chosen name for the setter
   * @param addComments If <code>true</code>, comments will be added.
   * @param flags The flags signaling visibility, if static, synchronized or final
   * @return Returns the generated stub.
   * @throws CoreException when stub creation failed
   */
  public static String getSetterStub(
      IField field, String setterName, boolean addComments, int flags) throws CoreException {

    String fieldName = field.getElementName();
    IType parentType = field.getDeclaringType();

    String returnSig = field.getTypeSignature();
    String typeName = Signature.toString(returnSig);

    IJavaProject project = field.getJavaProject();

    String accessorName = StubUtility.getBaseName(field);
    String argname = StubUtility.suggestArgumentName(project, accessorName, EMPTY);

    boolean isStatic = Flags.isStatic(flags);
    boolean isSync = Flags.isSynchronized(flags);
    boolean isFinal = Flags.isFinal(flags);

    String lineDelim =
        "\n"; // Use default line delimiter, as generated stub has to be formatted anyway
              // //$NON-NLS-1$
    StringBuffer buf = new StringBuffer();
    if (addComments) {
      String comment =
          CodeGeneration.getSetterComment(
              field.getCompilationUnit(),
              parentType.getTypeQualifiedName('.'),
              setterName,
              field.getElementName(),
              typeName,
              argname,
              accessorName,
              lineDelim);
      if (comment != null) {
        buf.append(comment);
        buf.append(lineDelim);
      }
    }
    buf.append(JdtFlags.getVisibilityString(flags));
    buf.append(' ');
    if (isStatic) buf.append("static "); // $NON-NLS-1$
    if (isSync) buf.append("synchronized "); // $NON-NLS-1$
    if (isFinal) buf.append("final "); // $NON-NLS-1$

    buf.append("void "); // $NON-NLS-1$
    buf.append(setterName);
    buf.append('(');
    buf.append(typeName);
    buf.append(' ');
    buf.append(argname);
    buf.append(") {"); // $NON-NLS-1$
    buf.append(lineDelim);

    boolean useThis = StubUtility.useThisForFieldAccess(project);
    if (argname.equals(fieldName) || (useThis && !isStatic)) {
      if (isStatic) fieldName = parentType.getElementName() + '.' + fieldName;
      else fieldName = "this." + fieldName; // $NON-NLS-1$
    }
    String body =
        CodeGeneration.getSetterMethodBodyContent(
            field.getCompilationUnit(),
            parentType.getTypeQualifiedName('.'),
            setterName,
            fieldName,
            argname,
            lineDelim);
    if (body != null) {
      buf.append(body);
    }
    buf.append("}"); // $NON-NLS-1$
    buf.append(lineDelim);
    return buf.toString();
  }