// GtkSharp.Generation.Method.cs - The Method Generatable. // // Author: Mike Kestner // // Copyright (c) 2001-2003 Mike Kestner // Copyright (c) 2003-2004 Novell, Inc. // // This program is free software; you can redistribute it and/or // modify it under the terms of version 2 of the GNU General Public // License as published by the Free Software Foundation. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU // General Public License for more details. // // You should have received a copy of the GNU General Public // License along with this program; if not, write to the // Free Software Foundation, Inc., 59 Temple Place - Suite 330, // Boston, MA 02111-1307, USA. namespace GtkSharp.Generation { using System; using System.Collections; using System.IO; using System.Xml; public class Method { private string libname; private XmlElement elem; private ReturnValue retval; private Parameters parms; private Signature sig; private ImportSignature isig; private MethodBody body; private ClassBase container_type; private bool initialized = false; private string call; private string name; private string protection = "public"; private bool is_get, is_set; private bool needs_ref = false; private bool deprecated = false; public Method (string libname, XmlElement elem, ClassBase container_type) { this.elem = elem; this.retval = new ReturnValue (elem["return-type"]); if (elem["parameters"] != null) { parms = new Parameters (elem["parameters"], container_type.NS); parms.Static = IsShared; } this.container_type = container_type; if (!container_type.IsDeprecated && elem.HasAttribute ("deprecated")) deprecated = elem.GetAttribute ("deprecated") == "1"; this.name = elem.GetAttribute("name"); if (name == "GetType") name = "GetGType"; if (elem.HasAttribute ("library")) this.libname = elem.GetAttribute ("library"); else this.libname = libname; // caller does not own reference? if (elem.HasAttribute ("needs_ref")) this.needs_ref = (elem.GetAttribute ("needs_ref") == "1"); } public string CName { get { return elem.GetAttribute ("cname"); } } public bool IsDeprecated { get { return deprecated; } } public bool IsGetter { get { return is_get; } } public bool IsSetter { get { return is_set; } } private bool IsShared { get { return elem.GetAttribute ("shared") == "true"; } } public string Name { get { return name; } set { name = value; } } public string Protection { get { return protection; } set { protection = value; } } public string ReturnType { get { return retval.CSType; } } string Safety { get { if (body.ThrowsException && !(container_type is InterfaceGen)) return "unsafe "; else return ""; } } public Signature Signature { get { return sig; } } public override bool Equals (object o) { if (!(o is Method)) return false; Method a = this; Method b = (Method) o; if (a.Name != b.Name) return false; if (a.Signature == null) return b.Signature == null; if (b.Signature == null) return false; return (a.Signature.Types == b.Signature.Types); } private bool Initialize () { if (initialized) return true; is_get = (((parms != null && ((parms.IsAccessor && retval.CSType == "void") || (parms.Count == 0 && retval.CSType != "void"))) || (parms == null && retval.CSType != "void")) && Name.Length > 3 && (Name.StartsWith ("Get") || Name.StartsWith ("Is") || Name.StartsWith ("Has"))); is_set = ((parms != null && (parms.IsAccessor || (parms.Count == 1 && retval.CSType == "void"))) && (Name.Length > 3 && Name.Substring(0, 3) == "Set")); sig = new Signature (parms); isig = new ImportSignature (parms, container_type.NS); body = new MethodBody (parms, container_type.NS); call = "(" + (IsShared ? "" : container_type.CallByName () + (parms != null ? ", " : "")) + body.GetCallString (is_set) + ")"; initialized = true; return true; } public bool Validate () { if (!Initialize ()) return false; if (parms != null && !parms.Validate ()) { Console.Write ("in method " + Name + " "); return false; } if (!retval.Validate ()) { Console.Write(" in method " + Name + " "); return false; } return true; } private Method GetComplement () { char complement; if (is_get) complement = 'S'; else complement = 'G'; return container_type.GetMethod (complement + elem.GetAttribute("name").Substring (1)); } public string Declaration { get { return retval.CSType + " " + Name + " (" + (sig != null ? sig.ToString() : "") + ");"; } } private void GenerateDeclCommon (StreamWriter sw, ClassBase implementor) { if (elem.GetAttribute ("shared") == "true") sw.Write("static "); sw.Write (Safety); Method dup = null; if (container_type != null) dup = container_type.GetMethodRecursively (Name); if (implementor != null) dup = implementor.GetMethodRecursively (Name); if (Name == "ToString" && parms == null) sw.Write("override "); else if (Name == "GetGType" && container_type is ObjectGen) sw.Write("new "); else if (elem.HasAttribute("new_flag") || (dup != null && dup.Initialize () && ((dup.Signature != null && sig != null && dup.Signature.ToString() == sig.ToString()) || (dup.Signature == null && sig == null)))) sw.Write("new "); if (is_get || is_set) { if (retval.CSType == "void") sw.Write (parms.AccessorReturnType); else sw.Write(retval.CSType); sw.Write(" "); if (Name.StartsWith ("Get") || Name.StartsWith ("Set")) sw.Write (Name.Substring (3)); else sw.Write (Name); sw.WriteLine(" { "); } else if (IsAccessor) { sw.Write (sig.AccessorType + " " + Name + "(" + sig.AsAccessor + ")"); } else { sw.Write(retval.CSType + " " + Name + "(" + (sig != null ? sig.ToString() : "") + ")"); } } public void GenerateDecl (StreamWriter sw) { if (!Initialize ()) return; if (elem.HasAttribute("shared") && (elem.GetAttribute("shared") == "true")) return; if (is_get || is_set) { Method comp = GetComplement (); if (comp != null && comp.Validate () && is_set) return; sw.Write("\t\t"); GenerateDeclCommon (sw, null); sw.Write("\t\t\t"); sw.Write ((is_get) ? "get;" : "set;"); if (comp != null && comp.is_set) sw.WriteLine (" set;"); else sw.WriteLine (); sw.WriteLine ("\t\t}"); } else { sw.Write("\t\t"); GenerateDeclCommon (sw, null); sw.WriteLine (";"); } Statistics.MethodCount++; } public void GenerateImport (StreamWriter sw) { string import_sig = IsShared ? "" : container_type.MarshalType + " raw"; import_sig += !IsShared && parms != null ? ", " : ""; import_sig += isig.ToString(); sw.WriteLine("\t\t[DllImport(\"" + libname + "\")]"); if (retval.MarshalType.StartsWith ("[return:")) sw.WriteLine("\t\t" + retval.MarshalType + " static extern " + Safety + retval.CSType + " " + CName + "(" + import_sig + ");"); else sw.WriteLine("\t\tstatic extern " + Safety + retval.MarshalType + " " + CName + "(" + import_sig + ");"); sw.WriteLine(); } public void Generate (GenerationInfo gen_info, ClassBase implementor) { Method comp = null; if (!Initialize ()) return; if (implementor != null && elem.HasAttribute("shared") && (elem.GetAttribute ("shared") == "true")) return; /* we are generated by the get Method, if there is one */ if (is_set || is_get) { if (!elem.HasAttribute("new_flag") && container_type.GetPropertyRecursively (Name.Substring (3)) != null) return; comp = GetComplement (); if (comp != null && comp.Validate () && is_set && parms.AccessorReturnType == comp.ReturnType) return; if (comp != null && is_set && parms.AccessorReturnType != comp.ReturnType) { is_set = false; call = "(Handle, " + body.GetCallString (false) + ")"; comp = null; } /* some setters take more than one arg */ if (comp != null && !comp.is_set) comp = null; } GenerateImport (gen_info.Writer); if (comp != null && retval.CSType == comp.parms.AccessorReturnType) comp.GenerateImport (gen_info.Writer); if (IsDeprecated) gen_info.Writer.WriteLine("\t\t[Obsolete]"); gen_info.Writer.Write("\t\t"); if (protection != "") gen_info.Writer.Write("{0} ", protection); GenerateDeclCommon (gen_info.Writer, implementor); if (is_get || is_set) { gen_info.Writer.Write ("\t\t\t"); gen_info.Writer.Write ((is_get) ? "get" : "set"); GenerateBody (gen_info, "\t"); } else GenerateBody (gen_info, ""); if (is_get || is_set) { if (comp != null && retval.CSType == comp.parms.AccessorReturnType) { gen_info.Writer.WriteLine (); gen_info.Writer.Write ("\t\t\tset"); comp.GenerateBody (gen_info, "\t"); } gen_info.Writer.WriteLine (); gen_info.Writer.WriteLine ("\t\t}"); } else gen_info.Writer.WriteLine(); gen_info.Writer.WriteLine(); Statistics.MethodCount++; } public void GenerateBody (GenerationInfo gen_info, string indent) { StreamWriter sw = gen_info.Writer; sw.WriteLine(" {"); if (IsAccessor) body.InitAccessor (sw, sig, indent); body.Initialize(gen_info, is_get, is_set, indent); SymbolTable table = SymbolTable.Table; IGeneratable ret_igen = table [retval.CType]; sw.Write(indent + "\t\t\t"); if (retval.MarshalType == "void") { sw.WriteLine(CName + call + ";"); } else if (ret_igen is ObjectGen || ret_igen is OpaqueGen) { sw.WriteLine(retval.MarshalType + " raw_ret = " + CName + call + ";"); sw.WriteLine(indent +"\t\t\t" + retval.CSType + " ret;"); sw.WriteLine(indent + "\t\t\tif (raw_ret == IntPtr.Zero)"); sw.WriteLine(indent + "\t\t\t\tret = null;"); sw.WriteLine(indent + "\t\t\telse"); sw.WriteLine(indent +"\t\t\t\tret = " + table.FromNativeReturn(retval.CType, "raw_ret") + ";"); } else if (ret_igen is CustomMarshalerGen) { sw.WriteLine(retval.CSType + " ret = " + CName + call + ";"); } else { sw.WriteLine(retval.MarshalType + " raw_ret = " + CName + call + ";"); sw.Write(indent + "\t\t\t"); string raw_parms = "raw_ret"; if (retval.ElementType != String.Empty) raw_parms += ", typeof (" + retval.ElementType + ")"; sw.WriteLine(retval.CSType + " ret = " + table.FromNativeReturn(retval.CType, raw_parms) + ";"); } body.Finish (sw, indent); body.HandleException (sw, indent); if (is_get && parms != null) sw.WriteLine (indent + "\t\t\treturn " + parms.AccessorName + ";"); else if (retval.MarshalType != "void") sw.WriteLine (indent + "\t\t\treturn ret;"); else if (IsAccessor) body.FinishAccessor (sw, sig, indent); sw.Write(indent + "\t\t}"); } bool IsAccessor { get { return retval.CSType == "void" && sig.IsAccessor; } } } }